Общая информация
Эта статья описывает интеграцию устройств Рутокен в мобильные приложения для платформы Android с использованием приложения "Панель управления Рутокен".
Начало встраивания в клиентские приложения
Существует несколько вариантов встраивания Рутокенов в клиентские Android-приложения.
...
- Добавьте в проект библиотекуиз Рутокен SDK. Библиотека находится в папке
<sdk>/mobile/android/pkcs11.
Положите библиотеку librtpkcs11ecp.so в папки <project_root>/app/src/main/jniLibs/armeabi-v7a и <project_root>/app/src/main/jniLibs/arm64-v8a для соответствующих архитектур.
Добавьте в проект модуль-обертку 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'
} |
| Status |
|---|
| colour | Green |
|---|
| title | РЕКОМЕНДУЕТСЯ |
|---|
|
Встраивание с использованием rtpcsc.aar
| Note |
|---|
Необходимая функциональность поддерживается начиная с версии Панели управления Рутокен 1.10.0 и новее, а также librtpkcs11ecp.so 2.4.2.0 и новее
|
...
- Установите последнюю версию (1.10.0 или новее) Панели управления Рутокен из Google Play.
- Добавьте в проект AAR модуль из Рутокен SDK: rtpcsc-<Version>.aar, где <Version> — версия библиотеки.
Модуль находится в папке <sdk>/mobile/android/pcsc. Положите rtpcsc-<Version>.aar в папку <project_root>/app/libs. - Пересоберите приложение.
Встраивание с использованием rtserviceconnection.aar
| Note |
|---|
Данный вариант встраивания совместим со всеми версиями Android, начиная с 5.0 |
...
- Установите Панель управления Рутокен версии 1.2.6 или новее из Google Play.
- Добавьте в проект библиотеку из Рутокен SDK. Библиотека находится в папке
<sdk>/mobile/android/pcsc. Положите библиотеку librtpcsc.so в папки <project_root>/app/src/main/jniLibs/armeabi-v7a и <project_root>/app/src/main/jniLibs/arm64-v8a для соответствующих архитектур. - Добавьте в проект AAR модуль из Рутокен SDK: rtserviceconnection-<Version>.aar, где <Version>— версия библиотеки.
Модуль находится в папке <sdk>/mobile/android/libs.
Положите rtserviceconnection-<Version>.aarв папку <project_root>/app/libs. - Пересоберите приложение.
Встраивание без дополнительного AAR модуля
| Note |
|---|
Данный вариант встраивания совместим только с версиями Android, начиная с 5.0 и заканчивая 8.1; версия targetSdk вашего приложения не должна превышать 27 |
...