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

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

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

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

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

Примечание

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

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

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

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

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

  1. Войти в каталог iOS

  2. Выбрать интересующий пример с помощью команды

    $ xcodebuild -list -workspace samples/iOSSamples.xcworkspace | grep -v common
    
  3. Собрать приложение (например GOST_appletStatus) и результат сборки положить в директорию _out с помощью команды

    $ xcodebuild -workspace samples/iOSSamples.xcworkspace -scheme GOST_appletStatus -configuration Release DSTROOT=../../_out clean install
    

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

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

Сборка тестовых примеров под 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 виден из остальных тестовых проектов, если их открыть;

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