Подключение Android SDK
Минимальная поддерживая версия Android: 21
Android SDK помогает реализовать вход по Сбер ID минимальными усилиями, а так же поддержать бесшовный опыт для пользователя.
Подключение
Используя Gradle:
- Добавьте репозиторий:
repositories {
mavenCentral()
}
- Подключите зависимость на SDK:
dependencies {
implementation 'io.github.sberid:SberIdSDK:4.0.0'
}
Версия может отличаться. Информацию об актуальной версии вы найдете в разделе «Файл Android SDK» зависимости для аналитики (см. Отправка аналитических событий)
Подключая aar файлом (legacy):
Добавьте файл .aar в папку libs вашего проекта:
Перейдите в build.gradle вашего модуля:
И добавьте зависимость в раздел dependencies:
dependencies {
...
implementation(name:'SberIdSDK', ext:'aar')
...
}
SDK реализована на языке Kotlin (версия 1.4.0), поэтому если в вашем проекте используется только Java и никакие дополнительные зависимости на Kotlin ранее не подключались, нужно добавить поддержку Kotlin (версия указана для примера, актуальна на момент написания документации):
dependencies {
...
implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.4.10")
...
}
Android Studio покажет предупреждение о том, что версия Kotlin Plugin (null) не соответствует версии подключенной библиотеки, но в данном случае подключение к проекту Kotlin Plugin не является обязательным. Все вызовы статических методов SDK в вашем Java-коде по примерам ниже необходимо выполнять через стандартный вспомогательный объект Companion, например:
SberIDLoginManager.Companion.SberIDBuilder sberIDBuilder = SberIDLoginManager.Companion.sberIDBuilder()
Перейдите в build.gradle вашего проекта:
Добавьте зависимость:
allprojects {
repositories {
flatDir {
dirs 'libs'
}
}
}
Перейдите в settings.gradle вашего проекта:
И подключите библиотеку к вашему проекту:
include ':SberIdSDK'
Поддержка Android 11+
Начиная с версии 1.3.1 SDK поддерживает определение видимости МП СБОЛ по требованиям, введенным в Андроид 11. Для возможности корректной сборки проекта необходимо, чтобы версия Android Gradle Plugin в вашем приложении была соответствующей. Подробнее про функционал видимости внешних пакетов можно ознакомиться в документации Google:
- https://developer.android.com/about/versions/11/privacy/package-visibility
- https://developer.android.com/studio/releases/gradle-plugin?hl=ru
Если версия Android Gradle Plugin будет ниже требуемой, при сборке проекте будет возникать ошибка Android resource linking failed. Для поддержки работоспособности достаточно минорного обновления версии Android Gradle Plugin в зависимости от той, которая у вас используется сейчас, подробнее про версии плагина можно прочитать здесь:
Минимально допустимая версия Android Gradle Plugin, поддерживающая требования в Андроид 11 - 3.3.3. Минимально допустимая версия Gradle, поддерживающая эту версию плагина - 4.10.1.