Android SDK

Обновлено 12 декабря 2025

Передайте в SDK по мере их инициализации следующие переменные используя метод SID.settings

Настройка SDK

Напоминание: перед настройкой UI необходимо выполнить базовую инициализацию SDK и применить базовые настройки.

Руководство по инициализации SDK для Android

Далее переходим к настройке пользовательского интерфейса перед его использованием.

Установка настроек

Далее необходимо применить настройки SDK. Это можно сделать сразу или позже, в зависимости от вашей реализации. Однако мы рекомендуем выполнить эту процедуру как можно раньше, так как от настроек зависит конфигурация SDK

Используйте следующие методы для настройки параметров:

• в модуле CORE Core- SID.Settings.setMainSettings()

Параметр	Кратность	Тип данных	Описание	Пример
clientID	1	String	ClientID приложения	40c1d5da-1532-11eb-adc1-0242ac120002
userID	0–1	String	ID пользователя (сгенерированный партнером идентификатор)	2ffuy3vv7sk11ddfsxn6
stand	0–1	String	Тип стенда (используется для тестирования)	—

Код

       public fun setMainSettings(
           clientID: String? = null,
           userID: String? = null,
           stand: StandName? = null,
       )

Пример установки всех параметров:

SID.Settings.setMainSettings(
    clientID = "ваш_clientID",
    userID = "ваш_userID",
    stand = StandName.IFT
)

• в модуле ELK ELK - SID.ELK.setProfileUrl(uri)

Параметр	Кратность	Тип данных	Описание	Пример
uri	0-1	String	URL для дополнительного запроса данных	40c1d5da-1532-11eb-adc1-0242ac120002

Код

public fun setProfileUrl(url: String)

Пример установки параметра:

SID.Settings.setProfileUrl(
    uri = "ваш_URL для дополнительного запроса"
)

Особенно важно своевременно передать clientID. Остальные параметры можно настроить позже, используя тот же метод. Передача нового значения параметра приведет к его перезаписи.

Настройка пользовательского интерфейса

Используйте метод SID.Settings.setUIPreferences() для настройки параметров:

Важно: если параметры не заданы, будут автоматически применены значения по умолчанию.

Все параметры опциональны

Объект	Тип	Описание
texts	SIDTextsELK?	Тексты ошибок (заголовок, описание, текст кнопки)
themeColor	SIDColorELK?	Акцентный цвет, используемый в интерфейсе.Сейчас цвет используется для:номера телефона+стрелочка в блоке пользователя;инициалы для аватарки и 0.2 цвета используют для фона аватарки (если цвета не указаны непосредственно в параметрах виджета)кнопки на экране ошибки
primaryColor	SIDColorELK?	Основной цвет текстов используемых в интерфейсе.
secondaryColor	SIDColorELK?	Вторичный цвет текстов используемых в интерфейсе.
warningColor	SIDColorELK?	Цвет предупреждений
widgetBackgroundColor	SIDColorELK?	Цвет фона виджетов
fonts	SIDFontsELK?	Настройки шрифтов
network	SIDNetworkELK?	Сетевые заголовки для запросов к бэкенду партнёра
elkErrorType	SIDErrorTypesELK?	Тип ошибки ЕЛК (например, NONE, TYPE_1 и т.д.)
dimensions (iOS)	SIDDimensions?	Отступы ЕЛК

Цвет — SIDColorELK

Параметр	Обязательность	Тип	Описание
light	0–1	Int	Цвет для светлой темы
dark	0–1	Int	Цвет для тёмной темы

Шрифты — SIDFontsELK

Параметр	Обязательность	Тип	Описание
semiBoldResID	0–1	Int	Идентификатор ресурса полужирного шрифта (R.font.xxx)
mediumResID	0–1	Int	Идентификатор ресурса среднего шрифта (R.font.xxx)

Текст ошибки — SIDTextsELK

Параметр	Обязательность	Тип	Описание	Значение по умолчанию
titleError	0–1	String	Заголовок ошибки	"Ой, ошибочка вышла"
descriptionError	0–1	String	Описание ошибки	"Загляните сюда позже — успеем загрузить к вашему возвращению"
buttonError	0–1	String	Текст кнопки ошибки	"Попробовать снова"

Тип экрана ошибки — SIDErrorTypesELK

Параметр	Обязательность	Тип	Описание	Возможные значения
named	0–1	String	Идентификатор типа ошибки	"NONE" — экран ошибки скрыт (по умолчанию) "TYPE_1" — стандартный экран ошибки "TYPE_2" — (устаревший, "Котик") "TYPE_3" — тематический экран (например, "Звук")

Отступы — SIDDimensionsELK (iOS)

Параметр	Обязательность	Тип	Описание
elkHorizontalPadding	0–1	Int	Горизонтальные отступы от краёв всего ЕЛК-контейнера
elkSpaceUserInfoMini	0–1	Int	Отступ справа в виджете USER_INFO_MINI

Настройки сетевых запросов - SIDNetwork

Параметр	Обязательность	Тип	Описание
headersELK	0–1	android - Map String, String<b/>iOS - [String: String]	Авторизационные хедеры Партнера

public class SIDPreferencesELK(
    public val texts: SIDTextsELK = SIDTextsELK(),
    public val themeColor: SIDColorELK = SIDColorELK(),
    public val primaryColor: SIDColorELK = SIDColorELK(),
    public val secondaryColor: SIDColorELK = SIDColorELK(),
    public val warningColor: SIDColorELK = SIDColorELK(),
    public val widgetBackgroundColor: SIDColorELK = SIDColorELK(),
    public val fonts: SIDFontsELK = SIDFontsELK(),
    public val network: SIDNetworkELK = SIDNetworkELK(),
    public val elkErrorType: SIDErrorTypesELK? = null,
)

Применить настройки

public fun setUIPreferences(preferences: SIDPreferencesELK): Unit