Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Начало встраивания в клиентские приложения

Существует несколько вариантов встраивания Рутокенов в клиентские Android-приложения.

Если вы используете систему сборки Gradle, то добавьте следующие строки в файл build.gradle:

Code Block
languagetext
themeFadeToGrey
android {
    defaultConfig {
        ndk {
            abiFilters "armeabi-v7a", "arm64-v8a"
        }
    }
}
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
} 

Если ваше приложение будет работать с Рутокенами через PKCS#11, то:

  1. Добавьте в проект библиотекуиз Рутокен SDK. Библиотека находится в папке <sdk>/mobile/android/pkcs11.
    Положите библиотеку librtpkcs11ecp.so в папки <project

Чтобы ваши приложения смогли работать с Рутокенами, в том числе в Android 9:

  1.  Установите последнюю версию Панели управления Рутокен из Google Play;
    Пересобирете ваше приложение c новыми библиотеками librtpkcs11ecp.so и librtpcsc.so из Рутокен SDK
    Библиотеки находятся в папках <sdk>\mobile\android\pkcs11\ и<sdk>mobile\android\pcsc\.
    Скорее всего библиотеки librtpkcs11ecp.so и librtpcsc.so в вашем проекте находятся  в папке `<project_root>/app/src/main/jniLibs/armeabi-v7a/`;
    и <project_root>/app/src/main/jniLibs/arm64-v8a для соответствующих архитектур.

  2. Добавьте в проект модуль-обертку PKSC#11 для Java из Рутокен SDK: pkcs11jna-<Version>.jar, где <Version>Убедитесь, что у вас последняя версия модуля-обертки PKSC#11 для Java – pkcs11jna<Version>.jar, где<Version>— версия библиотеки.
    Модуль находится
    по пути в папке <sdk>\/java\/samples\lib\ в Рутокен SDK;
    Положите pkcs11jna<Version>.jar в папку `<project_root>/app/libs/`
    Добавите себе в проект ARR модуль из Рутокен SDKrtserviceconnection<Version>.aar , где<Version>— версия библиотеки.
    Модуль находится по пути <sdk>\java\samples\lib\ в Рутокен SDK;
    Положите pkcs11jna<Version>.jar в папку `<project_root>/app/libs/`/pkcs11/lib.
    Положите
    pkcs11jna-<Version>.jar в папку <project_root>/app/libs.

Anchor
android12
android12
Status
colourGreen
titleРЕКОМЕНДУЕТСЯ
 
Встраивание с использованием rtpcsc.aar

Tip

Схема потребуется, когда targetSdk в вашем приложении станет уровня Android 12 или выше и вы используете Панели управления Рутокен 1.9.0 или новее, а также librtpkcs11ecp.so 2.4.2.0 и новее

Note

Необходимая функциональность поддерживается начиная с версии Панели управления Рутокен 1.9.0 и новее, а также librtpkcs11ecp.so 2.4.2.0 и новее 

Данный вариант встраивания совместим со всеми версиями Android, начиная с 5.0, и со всеми версиями targetSdk вашего приложения, начиная с 21.

Warning
titleВАЖНЫЕ ОТЛИЧИЯ

1. Потребуется обязательный вызов Java методаRtPcsc.setAppContext(context) из модуля rtpcsc-<Version>.aarи передать в него Android контекст вашего приложения до начала работы с устройствами Рутокен.
Наиболее подходящим местом для данного вызова будет метод
Application::onCreate. Без этого вызова работа с Рутокенами будет невозможна. Пример такого вызова можно увидеть в проекте Рутокен Демосмена.

2. Если приложение многопроцессное, то этот метод нужно вызвать в каждом процессе, где будет работа с устройствами Рутокен. Иначе в рамках процесса не получится работать с токенами или смарт-картами. 

3. Нельзя работать с библиотекой PKCS#11 из главного потока приложения. 

  1. Установите последнюю версию (1.9.0 или новее) Панели управления Рутокен из Google Play.
  2. Добавьте в проект AAR модуль из Рутокен SDK: rtpcsc-<Version>.aar, где <Version> — версия библиотеки.
    Модуль находится в папке
    <sdk>/mobile/android/pcsc. Положите rtpcsc-<Version>.aar в папку <project_root>/app/libs.
  3. Пересоберите приложение.

Встраивание с использованием rtserviceconnection.aar

Note

Данный вариант встраивания совместим со всеми версиями Android, начиная с 5.0, однако версия targetSdk вашего приложения не должна превышать 30.

Необходимая функциональность поддерживается начиная с Панели управления Рутокен версии 1.2.6.

Warning
titleВАЖНО

Версии rtserviceconnection.aar ниже 1.1.0 несовместимы с Панелью Управления Рутокен версии 1.9.0 и новее.

  1. Установите Панели управления Рутокен версию 1.2.6 или новее из Google Play.
  2. Добавьте в проект библиотеку из Рутокен SDK. Библиотека находится в папке <sdk>/mobile/android/pcsc. Положите библиотеку librtpcsc.so в папки <project_root>/app/src/main/jniLibs/armeabi-v7a и <project_root>/app/src/main/jniLibs/arm64-v8a для соответствующих архитектур.
  3. Добавьте в проект AAR модуль из Рутокен SDK: rtserviceconnection-<Version>.aar, где <Version>— версия библиотеки.
    Модуль находится в папке
    <sdk>/mobile/android/libs.
    Положите
    rtserviceconnection-<Version>.aarв папку <project_root>/app/libs.
  4. Пересоберите приложение.

Встраивание без дополнительного AAR модуля

Note

Данный вариант встраивания совместим только с версиями Android, начиная с 5.0 и заканчивая 8.1; версия targetSdk вашего приложения не должна превышать 27

 Данная схема работает с librtpcsc.so из SDK версии 040522 и ниже.

  1. Установите Панель управления Рутокен из Google Play.
  2. Добавьте в проект библиотеку из Рутокен SDK
    Библиотека находится в папке
    <sdk>/mobile/android/pcsc.
    Положите библиотеку
    librtpcsc.so в папки <project_root>/app/src/main/jniLibs/armeabi-v7a и <project_root>/app/src/main/jniLibs/arm64-v8a для соответствующих архитектур.
  3. Пересоберите приложение.