Page tree

Versions Compared

Key

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

...

Эта статья описывает интеграцию устройств Рутокен в мобильные приложения для платформы Android без использования приложения "Панель управления Рутокен".

Поддерживаемые версии Android

Android 7.0 (API Level 24) и выше.

Встраивание устройств Рутокен в проект

Для встраивания необходимо прописать следующую зависимость на библиотеку rtpcscbridge

UI Tabs
UI Tab
titleGradle (Groovy DSL)
Code Block
implementation 'ru.rutoken.rtpcscbridge:rtpcscbridge:1.0.0'


UI Tab
titleGradle (Kotlin DSL)
Code Block
implementation("ru.rutoken.rtpcscbridge:rtpcscbridge:1.0.0")



Tip
Библиотека доступна в репозитории Maven Central.

Точкой входа встраивания является класс ru.rutoken.rtpcscbridge.RtPcscBridge, который необходим для инициализации библиотеки rtpcscbridge.

Для каждого процесса приложения, в котором происходит взаимодействие с устройствами Рутокен, необходимо вызывать статический метод setAppContext и передавать ему в качестве параметра Android application context.

Типичное место вызова метода – внутри onCreate() класса-наследника Application.

Code Block
public class App extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        RtPcscBridge.setAppContext(this);
    }
}

Режимы использования встраивания

Встраивание поддерживает два режима использования:

UI Tabs
UI Tab
titleРучной режим

В данном режиме осуществляется явный вызов методов инициализации и финализации библиотеки, а также прямое управление отслеживанием устройств Рутокен с NFC.
Это обеспечивает полный контроль над поведением библиотеки со стороны приложения.

Например:
Активация встраивания только для части Activity приложения.

UI Tab
titleАвтоматический режим

В данном режиме встраивание активировано для всех Activity приложения, реализующих интерфейс OnNewIntentProvider.

Методы ручного API вызываются автоматически на определенных этапах жизненного цикла приложения.