ym88659208ym87991671
Release notes Android SDK | Документация для разработчиков
Развернуть

Release notes Android SDK

Обновлено 30 января 2026

Эта версия больше не поддерживается. Вместо нее используются две отдельные библиотеки: SIDSDK_CORE и SIDSDK_ELK.

  • SIDSDK_CORE - базовая библиотека для аутентификации: инициализация, настройка SDK, использование кнопки входа SIDButton..
  • SIDSDK_ELK - библиотека для работы с Единым Личным Кабинетом (ЕЛК), включает весь связанный с ним функционал.
ВерсияДата
1.8.1628.11.2025

Версия 1.8.17:

  • Исправление дефектов
    • Исправили отравку метрик в аналитическую систему ClickStream.

Версия 1.8.16:

  • Исправление дефектов
    • Исправлена ошибка в аналитике, вызванная исключением ClassCastException при преобразовании Boolean в String.

Версия 1.8.15:

  • Исправление дефектов
    • Исправили автоподстановку СМС кода в вебвью при логине/дологине.
    • Исправил ошибку с загрузкой виджетов, когда все виджеты отбросили ошибку, а секция в статусе лоад.

Версия 1.8.14:

  • Новое в ЕЛК
    • Исправлена ошибка, из-за которой виджеты могли перезагружаться при сворачивании и повторном разворачивании экрана.
    • Исправлено ошибочное удаление настроек ЕЛК при смене параметров headersELK.

Версия 1.8.13:

  • Новое в ЕЛК
    • Добавлена возможность задания минимального размера лоудера статики через методы вью и параметра композабла.
    • Восстановлен прежний порядок отображения ShowELK после окончания полной загрузки графа.

Версия 1.8.12:

  • Отображение загрузки виджетов ЕЛК
    • Изменена высота фрейма лоудера для контейнеров малого размера.

Версия 1.8.11:

  • Новое в ЕЛ
    • Обработаны спейсеры, исключающие установку элементов-спэйсеров.
    • Переименовано событие elementName в widgetName в коллбэках ЕЛК.
    • Изменено поведение отправки ShowELK: теперь оно отправляется при первом показанном виджете.

Версия 1.8.10:

  • ЕЛК. Доработки callback'ов
    • Исправлен параметр widgetName в callback'е.
    • Добавлено новое событие showWidgetELK.

Версия 1.8.9:

  • Исправления в ЕЛК
    • Устранено повторное открытие deeplink.
    • Улучшена производительность ELK Container View: устранено мерцание интерфейса у партнеров, применяющих view binding.

Версия 1.8.8:

  • ЕЛК. Цветовая коррекция виджета пользователя
    • Исправили отображение цветов для номера телефона и ФИО (цвета были перепутаны).

Версия 1.8.7:

  • Исправление ошибок и повышение производительности
    • Исправлены проблемы с работой системы отслеживания действий (clickstream)
    • Внутренняя оптимизация компонентов

Версия 1.8.6:

  • Приведение размеров виджетов в соответствие с гайдлайнами
    • Изменены размеры элементов под новые гайдлайны.
    • Расширена кликабельная область виджетов типа UserInfoMini, теперь активна вся поверхность элемента.

Версия 1.8.5:

  • Исправления минорных багов

Версия 1.8.4:

  • Новые поля для userInfoMini и расширение цветов аватара
    • Теперь можно изменять цвета аватара без картинки, текста аватара и номера телефона (по желанию).

Версия 1.8.3:

  • Добавление темы для активити с вебвью
    • Введена новая тема для экранов с вебвью.
    • Решена проблема возможных ошибок на некоторых устройствах.

Версия 1.8.2:

  • Исправление дублирования заголовков в ЕЛК
    • Исправлено дублирование заголовков (например, "Authorization") при добавлении партнером.
    • Теперь авторизация на бекенде партнера проходит корректно.

Версия 1.8.1:

  • Новое в ЕЛК
    • Пользователи теперь могут смахивать нерелевантные баннеры, а SDK собирает статистику взаимодействий

Версия 1.8.0:

  • Новое в ЕЛК

    • Появилась возможность внедрять кастомные элементы в ЕЛК

  • Технические улучшения

    • Добавили цепочку сертификатов для безопасных сетевых запросов
    • Обеспечили защиту от десериализации пустых строк

Версия 1.7.0:

  • Новое в ЕЛК

    • Улучшения шиммеров и загрузки данных
    • Исправили падение диплинков
    • Улучшение аналитики: расширены метрики

  • Исправление ошибок инициализации SDK

    • Реализована повторная переинециализация зависимостей внутри

Версия 1.6.0:

  • Добавили новое событие для ЕЛК

    • OpenWidgetELK для открытия внутренних линков партнера

  • Доработали доавторизацию

    • Добавлены ожидания авторизации партнера

  • Обновили ClickStream

    • Предыдущие версии могут не отбрасывать события из-за сертификатов

  • Исправили ошибку при авторизации в WebView

    • При отмене авторизации могло быть падение или фриз UI

  • Обновление WebView

    • Измененили интерфейс управления и открытие pdf внутри WebView

Версия 1.5.0:

  • В ЕЛК появилось возможность добавлять дополнительный контейнер

    • В рамках новой доработки изменился механизм версионности SDK и названия статики (подробнее в документации ЕЛК)

  • Скрыли публичные классы, которые не должны были быть видны

  • Deprecation CustomFonts

  • Исправили ошибку вызова браузера

    • Когда, телефон выдавал неправильный ответ с кол-вом браузеров, не являющейся действительности и мы из-за этого не открывали ссылку на авторизацию

  • Удалили остатки KTOR

Версия 1.4.0:

  • Проработали аналитику ЕЛК при перезагрузке

    • Теперь будет отправляться повторно, если пользователь перезапустил ЕЛК.

  • Добавили возможность отправки аналитических событий для партнеров

    • Актуально для пользователей React Native SDK или тех, кто решил делать свою реализацию ЕЛК

  • Удалили библиотеку для сетевого взаимодействия - KTOR

    • Мы давно отказались от него, настало время удалить его полностью

Версия 1.3.1:

  • Добавили поддержку темной темы для WebView

  • Зафиксировали ориентацию экрана для WebView

  • Проработали обфускацию кода, благодаря чему сократили размер SDK на 30%.

При переходе на версию с 1.3.1 и выше, необходимо внимательно протестировать вашу сборку в develop и release варианте всех сценариев Сбер ID.

Версия 1.3.0:

  • Добавили зависимости для реакта

    • теперь партнеры использующие react будут гарантированно подключать зависимости для их работы.

  • Сделали инициализацию более понятной

    • создали и настроили ошибку, если партнер попытается запустить методы СДК до инициализации и добавили флаг isInitialized.

  • Заменили старое вебвью

    • Теперь открываем новый экран без шапки.

  • Изменили апи получения URI

    • старый метод задеприкейтели, новый сделали без clientID (метод createUriForLogin).

  • Удалили анимацию у вебвью

    • исправили анимацию, которая возникала из-за экспериментальной версии апи

  • Добавили сценарий доавторизации в ELK.

  • Добавлена автоподстановка ОТП кода из смс для вебвью.

Версия 1.1.1:

  • Исправление анимации прокрутки в шторке бесшовного перехода

Версия 1.1.0:

  • Добавлена дополнительная проверка WebView при запуске

    • Для ситуаций, когда на устройстве нет WebView, такое может быть на специфичных устройствах

  • Убрали лишние логи CustomTabs

    • Раннее на устройствах, которые не поддерживают CustomTabs в стактрейс отправлялись ненужные логи

Версия 1.0.6:

  • Исправление загрузки конфига управления SDK

Версия 1.0.5:

  • Исправление UI элементов управления экраном входа

  • Исправление loginWithNativeWebView

    • Исправлена ошибка, когда внутри метода loginWithNativeWebView могла формироваться неправильная итоговая ссылка

Версия 1.0.4:

  • Заменили упоминания sberid на sid

    • В новой SDK мы поменяли основной пакет с sberid на sid, из-за чего необходимо поправить все импорты.

  • Поднятие версии Koin до 3.5.3

    • Обратите внимание, что более низкая фичевая версия Koin может ломать сборку. Убедитесь, что ваш проект использует версию схожую с 3.5.3. Мы уже думаем как в будущем уйти от этой проблемы.

  • Добавлены новые виджеты личного кабинета

    • В данном релизе добавлены новые виджеты для единого личного кабинета.

Старая версия

Обновлено 30 января 2026

Важные изменения релиза версии 4.2.3:

  • Поднятие версии Koin до 3.5.3

    • Обратите внимание, что более низкая фичевая версия Koin может ломать сборку. Убедитесь, что ваш проект использует версию схожую с 3.5.3. Мы уже думаем как в будущем уйти от этой проблемы.

  • Добавлены новые виджеты личного кабинета

    • В данном релизе добавлены новые виджеты для единого личного кабинета.

    Важные изменения релиза версии 4.2.2:

  • **Оптимизация зависимостей

  • Мы уменьшили количество зависимостей, что сделало SDK более легким и стабильным. Убраны некоторые зависимости, которые могли вызывать уведомления при публикации в магазинах.

  • Новый сценарий входа

  • Мы представляем новый сценарий входа, который сейчас находится на стадии пилотного тестирования. В будущем мы добавим полное описание его использования.

  • Исправление UI ЕЛК

  • В этом обновлении мы исправили ошибку, из-за которой верстка некоторых виджетов могла отображаться некорректно.

  • Обработка ошибок при инициализации

  • Обработали некоторые кейсы, когда внутрь SDK передавали null параметры

Важные изменения релиза версии 4.0.0:

1. Обновление пути к сущности StandName:

Было: import sberid.sdk.auth.model.StandName

Стало: import sberid.sdk.global.models.StandName

2. Новый метод для инициализации client id:

Теперь у нас есть отдельный метод, который позволяет инициализировать client id после запуска SDK: setClientID(clientID: String)

	SID.Initializer.setClientID(clientId = "clientId вашего сервиса")

3. Исправление ошибки:

Теперь исправлена проблема, из-за которой запускался старый домен страницы входа.

О версии 3.0.0

Добавлена возможность загрузки настроек SDK без кнопки Сбер ID

Начиная с версии 3.0.0 добавлен новый способ инициализации SDK SberIDInitializer.initialize. Используя этот метод, можно больше не передавать через верстку или конструктор clientId (смотри пункт "Добавление кнопки").

Данный метод в будущем станет обязательным, сейчас можно начинать переходить на него.

/**
 * Метод инициализирует SDK.
 * @param application необходим для создания зависимостей
 * @param clientId    нужен для проверки доступности SDK и загрузки настроек
 */
fun initialize(application: Application, clientId: String)

Его необходимо вызвать при создании вашего Application и передать два параметра application и client_id.

class MyApplication : Application() {

    override fun onCreate() {
        super.onCreate()
        SberIDInitializer.initialize(this, this.getString(R.string.client_id_1))
    }
}

О версии 2.4.3

Исправили проверку браузеров на возможность открытие CustomTabs

О версии 2.4.2

Передача номера на OIDC страницу

Добавлена возмость отправки номера телефона на OIDC страницу через новый параметр login_hint

Пример

//Создание Uri с параметрами для аутентификации, все значения нужно поменять на свои, тут указаны примеры
val uri = SberIDLoginManager
    .sberIDBuilder()
    .clientID("512e1152-e14c-5223-a125-d519eb68bb86")
    .scope("openid name email mobile birthdate gender")
    .state("ffad1d59c1e34844a1415226103d44f3")
    .nonce("b1947d4f10a24eb0a21155239be9b066")
    .redirectUri("app://merchant_app/")
    .loginHint("79998887766") // Необязательный параметр для передачи номера телефона пользователя, добавлен в версии 2.4.2
    .codeChallenge(codeChallenge) //Необязательный параметр...

О версии 2.4.1

Создание кнопки Сбер ID через конструктор

Начиная с версии 2.4.1 появилась возможность создавать кнопку через конструктор, без xml. Данный способ актуален для партнеров, которые используют мультиплатформенные фреймворки, например Flutter.

val sberIDButton = SberIDButton(
    context = this,
    sberIDButtonModel = SberIDButtonModel(
        clientId = "4361-69c-43e-87e1-3fd6351", //id приложения партнера
        width = 120,   // размер кнопки в dp
        height = 40, // размер кнопки в dp
        type = ButtonType.DEFAULT_TYPE, // тип кнопки, Enum класс ButtonType
        text = ButtonText.LOGIN_SHORT,  // текст кнопки, Enum класс ButtonType
        cornerRadius = 4, // скругление кнопки в dp
        strokeColor = Color.rgb(76, 76, 76), //цвет граней для белой кнопки
        buttonLoader = false // нужно ли отображать загрузку со старта
    )
)

// Описание Enum класса для типа кнопки
ButtonType {
    DEFAULT_TYPE, // Зеленная кнопка,
    WHITE_TYPE    // Белая кнопка
}

// Описание Enum класса для текста кнопки
ButtonText {
    LOGIN_SHORT, // Сбер ID,
    CONTINUE,    // Продолжить cо Сбер ID
    FILL         // Заполнить cо Сбер ID
}

//Далее добавляем ее в ирархию виджетов
container.addView(sberIDButton)

Необходимо направить запрос на support_sberid@sber.ru на добавление deeplink в список доверенных. В запросе указывается client_id и список deeplink, по которым будет производиться возврат в мобильное приложение партнера. Сотрудник банка добавит домен в список разрешенных.

Смена стенда внутри SDK

Начиная с версии 2.4.1 для внутренних партнеров мы добавили возможность смены стендов внутри SDK, для тестирования на ИФТ стенде. Предворительно у вас должно быть настроена полная интеграция с тестовыми стендами, а так же вы как партнер должны быть добавлены на ваш стенд. Для этого можно написать в ваш чат поддержки Сбер ID (Ваш_продукт & Сбер ID) или на почту support_sberid@sber.ru

Для настройки стенда нужно передать в конструктор SberIDLoginManager тип стенда, для это нужно использовать Enum класс StandName:

    SberIDLoginManager(StandName.ESA_IFT) // по умолчанию StandName.PROM

Обратите внимание, стенды cloud и ЕСА отличаются.


    /**
     * Нестабильный стенд Сloud Сбер ID, на котором ведется разработка
     */
    CLOUD_IFT,

    /**
     * Нестабильный стенд ЕСА, на котором ведется разработка
     */
    ESA_IFT,

    /**
     * Стенд по умолчанию, не имеет разбивки так как работает через конфиг файл.
     * Сейчас оставляем самый популярный бэк
     */
    PROM

Заметили ошибку?
Выделите текст и нажмите
Ctrl
+
Enter
, чтобы сообщить нам об ошибке
Развернуть