Файлы и каталоги в архиве

• odt – этот документ
• Каталог exec – каталог, в котором будут размещены собранные файлы проекта (dll и jar)
• Каталог SAPIImpl.java – рабочая область среды разработки eclipse
  • luwrain.windows.speech – пакет, содержит единственный класс SAPIImpl
  • SAPIImplTest – содержит класс для запуска тестового приложения
• Каталог SAPIImpl.cpp – проекты Visual Studio
  • SAPIImpl - исходные файлы динамической библиотеки dll для вызова методов SAPI
  • ExportConstants - исходные файлы утилиты формирования java класса с иннициализацией констант SAPI
• SAPIImpl\org_luwrain_windows_speech_SAPIImpl.h – автоматически созданный файл заголовков методов c++ (формируется автоматически с помощью dosyncmake.bat)
• файл dosyncmake.bat – BATCH-программа, выполняющая различные операции по переносу необходимых файлов между проектами java и c++, эту утилиту необходимо запускать как минимум после структурных изменений в любом из проектах
  
  • генерирует заголовочнй файл из класса JNI проекта java для cpp
  • генерирует класс java с константами из SAPI с помощью утилиты ExportConstants
  • копирует собранные dll (пока использует debug версии) и переименовывает их как 32 и 64, для соответствующих архитектур
  • собирает jar файл

Инструкция по сборке проекта

1. Распаковать архив в пустой каталог, например, C:\Work\ (в нем появятся каталоги SAPIImpl.cpp, SAPIImpl.java, файл dosyncmake.bat и т.п.)
2. Запустить eclipse и указать рабочим каталогом каталог C:\Work\SAPIImpl.java\
3. Выбрать в меню Project -> Build All
4. Запустить BATCH-файл dosyncmake.bat (при первом запуске возможны ошибки копирования).
   это необходимо для обновления заголовочного файла методов JNI
5. Запустить Microsoft Visual Studio и открыть проект C:\Work\SAPIImpl.cpp\ SAPIImpl.sln
6. Выбрать в тулбаре выбора текущей конфигурации (когда выбирают Debug/Release) меню Configuration Manager и сменить платформу для проекта SAPIImpl на x64 (если этого выбора нет, то его можно добавить, выбрав New, затем выбрав New Platform -> x64)
7. Вызвать сборку проекта (Ctrl+Shift+B либо через меню Build -> Build Solution)
8. Снова открыть Configuration manager и сменить платформу на Win32
9. Еще раз вызвать сборку проекта в Visual Studio
10. Повторно запустить BATCH-файл dosyncmake.bat
    это скопирует dll файлы и соберет jar файл

Запуск тестов

(пути к java могут отличаться на вашей машине, в зависимости от установленной версии)

• Запуск 32-битной версии
  "C:\Program Files (x86)\Java\jre8.0_31\bin\java.exe" -jar SAPIImplTest.jar
• Запуск 64-битной версии
  "C:\Program Files\Java\jre1.8.0_31\bin\java.exe" -jar SAPIImplTest.jar