Сборка тестовых примеров

Сборка тестовых примеров под iOS

Подготовка к сборке тестовых примеров для iOS

Каталог iOS из состава JC-Mobile SDK имеет следующую структуру:

• каталог lib со всеми необходимыми библиотеками;
• каталог sources с примерами использования SDK.

Примечание

При сборке примеров необходимо, чтобы относительное расположение папок lib и sources сохранялось, так как примеры включают в процесс сборки библиотеки именно из папки lib

Сборка тестовых примеров в IDE Xcode

Требования к сборочной и отладочной среде:

• для сборки примеров необходимо наличие установленного Xcode версии 7.1 или 7.2;
• для сборки из командной строки необходимо установить Command Line Tools для Xcode 7.1 или 7.2.

Последовательность действий при сборке примеров из командной строки

1. Собрать общую для всех примеров библиотеку libcommon.a, для этого перейти в каталог common и выполнить следующую команду:

   xcodebuild -project common.xcodeproj/

2. Собрать пример GOST_appletStatus, для этого перейти в каталог примера и выполнить команду сборки:

   xcodebuild -project GOST_appletStatus.xcodeproj

Последовательность действий при сборке с помощью xCode

1. Открыть все проекты, используя меню File -> Open-> iOSSamples.workspace.
2. Собрать общую для всех примеров библиотеку libcommon.a, выбрав соответствующий проект на верхней панели из выпадающего списка. Для этого нажать клавиши CMD+B или выбрать пункт меню Product -> Build.
3. Выбрать интересующий проект на верхней панели из выпадающего списка, затем собрать его аналогично библиотеке libcommon.a.

Сборка тестовых примеров под Android

Подготовка к сборке тестовых примеров для Android

Каталог android из состава JC-Mobile SDK имеет следующую структуру:

• каталог libs со всеми необходимыми библиотеками;
• каталог sources с примерами использования SDK.

Примечание

При сборке примеров необходимо, чтобы относительное расположение папок libs и sources сохранялось, так как примеры включают в процесс сборки библиотеки именно из папки libs.

Необходимо явно предоставить приложению доступ к MicroUSB-токену и bluetooth смарт-карт ридеру. Для этого перед инициализацией библиотеки jcPKCS11 с помощью функции C_Initialize() следует вызвать соответствующие методы, входящие в JC-Mobile SDK:

• для работы только с MicroUSB-токенами следует вызвать метод JNA.allowUSBHost(this, true);
• для работы только с bluetooth-ридерами следует вызвать метод JNA.allowBluetooth(true);
• для работы и с MicroUSB-токенами и bluetooth-ридерами следует вызвать оба метода.

Примечание

При работе в нескольких контекстах необходимо вызывать методы JNA.allowUSBHost и / или JNA.allowBluetooth с параметром false перед закрытием каждого контекста.

Сборка тестовых примеров с помощью ant

Для сборки тестовых примеров необходимо наличие установленных Android SDK и системы сборки Apache-ant. Системная переменная PATH должна содержать пути к Android tools и Apache-ant, например, /Users/admin/Library/android/android-sdk/platform-tools:/Users/hudson/Library/apache-ant-1.9.4:/Users/admin/Library/android-sdk/build-tools/20.0.0/.

Также необходимо открыть в папке sources файл local.properties и убедиться, что правильно указан параметр sdk.dir - в нем необходимо указать путь к используемой версии Android SDK, например, sdk.dir=/Users/admin/Library/android/android-sdk/.

Для корректой работы примеров для Android необходимо предварительно выполнить сборку проекта common.

Для этого можно воспользоваться интерфейсом командной строки.

1. Находясь в корневой папке SDK, выполнить команду:

   ant -f ./sources/common/common-build.xml release

   В результате выполнения команды в папке ./sources/libs должен появиться файл common.jar.

2. После этого сборка собственно тестовых примеров осуществляется командами:

   ant -f ./sources/GOST_{sampleName}/build.xml release

   ant -f ./sources/PKI_{sampleName}/build.xml release

Сборка тестовых примеров в IDE Eclipse

Второй способ сборки тестовых примеров - с помощью IDE Eclipse. Рекомендуется использовать версию IDE Eclipse 4.4.0 совместно с ADT плагином (http://developer.android.com/intl/ru/sdk/installing/installing-adt.html).

Предварительно нужно выполнить следующие действия:

1. добавить тестовые примеры в workspace, для чего на панели Package Explorer вызвать контекстное меню и выбрать пункт Import > Existing Projects into Workspace и указать путь к папке sources с примерами;

   Примечание

   Флажок Copy projects into workspace должен быть снят.

2. удостовериться, что выполнилась автосборка проекта common - имеется файл common.jar в папке bin этого проекта;

3. скопировать файл common.jar в папку ./sources/libs;

4. проследить, что common.jar виден из остальных тестовых проектов, если их открыть;

После выполнения этих действий можно проводить сборку и запуск тестовых примеров.