Интеграция в iOS приложение

Для подключения JC-Mobile SDK к приложению необходимо внести определенные изменения в Xcode проект.

Предположим, что проект имеет следующую структуру:

../../../_images/project_fs.png

Шаги по интеграции в проект:

  1. В Linked Frameworks and Libraries добавить:

    • ExternalAccessory.framework;
    • CoreBluetooth.framework;
    • libssl.a;
    • libcrypto.a;
    • libjcPKCS11-2.a.

    Примечание

    Если API JC-Mobile SDK вызывается в файлах с расширением *.m, то дополнительно требуется добавить libc++.tdb.

    ../../../_images/linked_libs.png
  2. В Build Settings отключить Bitcode установив в параметр Enable Bitcode значение No.

    ../../../_images/bitcode.png
  3. В Build Settings в параметр Header Search Paths добавить путь к директории заголовочных файлов jcPKCS11/include, входящей в состав дистрибутива.

    ../../../_images/header_sp.png
  4. В Build Settings в параметр Library Search Paths добавить пути к директории с библиотеками jcPKCS11/lib и openssl/lib, входящих в состав дистрибутива.

    ../../../_images/lib_sp.png
  5. В Info.plist добавить ключ Supported external accessory protocols со следующими значениями:

    • com.ftsafe.iR301 - для ридеров iR301-UL c разъемом Lightning;
    • com.ftsafe.bR301 - для Bluetooth ридеров bR301.
    ../../../_images/info_plist.png
  6. В Info.plist добавить ключ NSBluetoothPeripheralUsageDescription и предупредить пользователя, что приложение может работать с Bluetooth-устройствами.

    Важно

    Без этого ключа приложение не пройдет проверку в App Store Connect.

  7. Для использования API в исходном коде необходимо импортировать файл jcPKCS11.h.

    #import "jcPKCS11.h"