Для получения комплекта разработчика JC-Mobile SDK Android оформите заявку.
Каталог содержит примеры по работе с Единой библиотекой PKCS #11.
Полный список примеров представлен в разделе Список примеров.
Для работы с устройствами JaCarta используется Java-обертка над единой библиотекой PKCS #11, предоставляющая высокоуровневый интерфейс (см. API Единой библиотеки PKCS #11) для взаимодействия по стандарту PKCS #11 v2.30.
Рассмотрим пример встраивания в приложение проект которого создан в IDE Eclipse for Java Developers.
Проект будет иметь следующую файловую структуру:
Шаги по интеграции в проект:
В Java Build Path в закладку Libraries добавить:
Установить из магазина приложений Google Play приложение JaCarta Service для обеспечения поддержки работоспособности устройств JaCarta.
Для администрирования смарт–карт JaCarta ГОСТ, JaCarta PKI и JaCarta PKI/ГОСТ следует использовать ПК Единый Клиент JaCarta, установленный на ПК.
Выполнить подготовку сборочного окружения
Установить java 1.8
Установить Android SDK
Скопировать tools из android-sdk версии 25
Установить утилиту для автоматизации сборки Apache Ant
Задать переменные среды для Android SDK build-tools и утилиты автоматизации сборки Ant
Например:
export ANTROOT="/Users/username/Library/android/apache-ant"
export ANDROID_HOME="/Users/username/Library/android/android-sdk"
Добавить в переменную PATH пути до папки, где установлен Android SDK и утилита автоматизации сборки Ant
Например:
export PATH=${PATH}:/Users/username/Library/android/apache-ant/bin
export PATH=${PATH}:/Users/username/Library/android/android-sdk/build-tools/28.0.2
export PATH=${PATH}:/Users/username/Library/android/android-sdk/platform-tools
Выполнить сборку компонента common.jar. для этого нужно выполнить следующие действия:
перейти в директорию с компонентом common и выпонить команду:
$ant -f common-build.xml debug
результат сборки окажется в папке libs в виде файла common.jar.
Выполнить сборку интересующего примера:
перейти в директорию с необходимым примером (например ./sources/GOST2_info) и выполнить команду:
$ant -f build.xml debug
результат сборки окажется в папке ./sources/GOST2_info/bin, в виде файла GOST2_info-debug.apk.
Рассмотрим пример сборки в среде Eclipse for Java Developers. Для сборки необходимо, чтобы был прописан путь к Android SDK, который указывается в настройках Eclipse->Preferences->Android в поле SDK Location. По указанному пути должны быть предустановлены необходимые SDK platform, platform-tools и build-tools. Например:
Если сборочное окружение настроено корректно, то шаги по сборке выглядят следующим образом:
Скопировать папку libs и ее содержимое в корневую директорию проекта компонента common и проекта с необходимым примером.
Открыть IDE Eclipse for Java Developers.
Выполнить иморт проекта компонента common и проекта интересующего примера выбрав пункт “Existing Projects into Workspace”.
Добавить библиотеку jcPKCS11-2.jar для компонента common в Java Build Path в закладку Libraries.
Собрать компонент common, выбрав выбрав пункт Build Project из выпадающего меню выбрав пункт меню Project -> Build Project. в папке common/bin окажется файл common.jar
Скопировать файл common.jar в папку libs проекта примера.
Добавить библиотеку jcPKCS11-2.jar и common.jar Java Build Path в закладку Libraries для проекта примера.
Для запуска примера на смартфоне необходимо создать конфигурацию, для чего щелкнуть на проекте правой кнопкой мыши и выбрать пункт меню Run As -> Run Configurations.
В открывшейся форме выбрать пункт Android Aplication и настроить ее.
Подключить смартфон и нажать кнопку Run.