Общая информация
Эта статья описывает интеграцию устройств Рутокен в мобильные приложения для платформы Android без использования приложения "Панель управления Рутокен".
Поддерживаемые версии Android
Android 7.0 (API Level 24) и выше.
Встраивание устройств Рутокен в проект
Для встраивания необходимо прописать следующую зависимость на библиотеку rtpcscbridge:
implementation 'ru.rutoken.rtpcscbridge:rtpcscbridge:1.0.0'
implementation("ru.rutoken.rtpcscbridge:rtpcscbridge:1.0.0")
Точкой входа встраивания является класс ru.rutoken.rtpcscbridge.RtPcscBridge, который необходим для инициализации библиотеки rtpcscbridge.
Для каждого процесса приложения, в котором происходит взаимодействие с устройствами Рутокен, необходимо вызывать статический метод setAppContext и передавать ему в качестве параметра Android application context.
Типичное место вызова метода – внутри onCreate() класса-наследника Application.
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
RtPcscBridge.setAppContext(this);
}
}
Режимы использования встраивания
Встраивание поддерживает два режима использования:
В данном режиме осуществляется явный вызов методов инициализации и финализации библиотеки, а также прямое управление отслеживанием устройств Рутокен с NFC.
Это обеспечивает полный контроль над поведением библиотеки со стороны приложения.
Например:
Активация встраивания только для части Activity приложения.
В данном режиме встраивание активировано для всех Activity приложения, реализующих интерфейс OnNewIntentProvider.
Методы ручного API вызываются автоматически на определенных этапах жизненного цикла приложения.