Руководство по работе с SDK

Получение

Для получения комплекта разработчика JC-Sign SDK iOS оформите заявку.

Состав SDK

Каталог “frameworks”

Каталог содержит:

  • основной фреймворк SDK для iOS: JCSign.framework
  • фреймворк OpenSSL: JCOpenSSL.framework
  • фреймворк GOST Engine для OpenSSL: JCOpenSSLGostEngine.framework

Каталог “samples”

Каталог содержит два примера по работе с JCSign SDK, на языке Swift (JCSignSample_Swift) и на языке Objective-C(JCSignSample_ObjC)

Встраивание

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

Рассмотрим пример встраивания в приложение, проект которого создан в XCode для языка Swift.

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

  1. Скопируйте папку frameworks в удобное место.

  2. Выберете корневой элемент структуры проекта и откройте вкладку Build Phases.

  3. На открывшейся вкладке раскройте элемент Link Binary With Libraries. Через элемент + добавьте три фреймфорка из содержимого папки “frameworks”

    ../../_images/ios_add_framework.png
  4. Структура проекта станет выглядеть как на картинке ниже

    ../../_images/ios_project_fs1.png
  5. Во вкладке “Info” добавить ключ com.apple.developer.nfc.readersession.iso7816.select-identifiers со следующими значениями:

    ../../_images/ios_info_plist_nfc_aids2.png

    список поддерживаемых AID:

    • A000000448000101
    • A0000001644C41534552
    • A0000001644C415345520001
    • A000000448000D01
    • A0000001510000
    • A000000003000000
  6. Во вкладке “Info” добавить ключ NFCReaderUsageDescription для информирования пользователя, о том, что приложение может работать с NFC.

    Важно

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

    ../../_images/ios_info_plist_nfc2.png
  7. Для использования фреймворка в исходных текстах выполните импорт

import JCSign

Администрирование смарт-карт JaCarta

Для администрирования смарт-карт следует использовать ПК Единый Клиент JaCarta, установленный на ПК.