Page tree

Versions Compared

Key

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

...

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

  2. Добавьте в проект модуль-обертку PKSC#11 для Java: ru.rutoken:pkcs11jna:<version>@jar, где <Version> — версия библиотеки.
    Актуальную версии библиотеки можно посмотреть здесь.
    Также вам понадобится зависимость: net.java.dev.jna:jna:<Version>@aar.
    Её актуальную версию можно посмотреть здесь.

    Code Block
    titleПример добавленных зависимостей (для Gradle)
    dependencies {
        implementation 'ru.rutoken:pkcs11jna:3.3.0@jar'
        implementation 'net.java.dev.jna:jna:5.11.0@aar'
    }

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

Tip

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

Note

Необходимая функциональность поддерживается начиная с версии Панели управления Рутокен 1.10.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.10.0 или новее) Панели управления Рутокен из Google Play.
  2. Добавьте в проект AAR модуль из Рутокен SDK: rtpcsc-<Version>.aar, где <Version> — версия библиотеки.
    Модуль находится в папке 
    <sdk>/mobile/android/pcsc. Положите rtpcsc-<Version>.aar в папку <project_root>/app/libs.
  3. Пересоберите приложение.

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

...