Инициализация и базовая настройка

Обновлено 19 июня 2024

Для использования основного функционала SDK обратитесь к статическим свойствам класса SID.

Инициализация

Инициализируйте SDK Sber ID при старте вашего приложения. Это позволит загрузить необходимые данные для авторизации еще до их использования.

• Swift
• Objective C

SID.initializer.initialize()

[SID initializer initialize];

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

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

• Swift
• Objective C

/// Применить основные настройки
/// - Parameters:
///   - clientID: ClientID приложения
///   - userID: ID пользователя
///   - partnerName: Имя / название приложения
///   - partnerProfileUrl: URL для дополнительного запроса данных
///   - stand: Тип стенда (используется для тестирования)
SID.settings.applyMainPreferences(
    clientID: "clientID",
    userID: "userID",
    partnerName: "partnerName",
    partnerProfileUrl: "partnerProfileUrl",
    stand: .prom
)

/// Применить основные настройки
/// - Parameters:
///   - clientID: ClientID приложения
///   - userID: ID пользователя
///   - partnerName: Имя / название приложения
///   - partnerProfileUrl: URL для дополнительного запроса данных
///   - stand: Тип стенда (используется для тестирования)
[SID settings applyMainPreferencesWithClientID:@"clientID"
                                        userID:@"userID"
                                   partnerName:@"partnerName"
                             partnerProfileUrl:@"partnerProfileUrl"
                                         stand:SIDStandTypeProm];

Для параметра stand доступны следующие значения: .prom (продакшн), .ift, .psi, .iftCloud, .psiPrcloud.

Настройка UI

Настройте параметры UI перед их использованием. Если параметры не заданы, будут использоваться значения по умолчанию.

• Swift
• Objective C

/// При отсутствии значений используются значения по умолчанию.
/// - Parameters:
///   - texts: Тексты, используемые в интерфейсе.
///   - themeColor: Основной цвет темы интерфейса.
///   - primaryColor: Основной цвет элементов интерфейса.
///   - secondaryColor: Вторичный цвет элементов интерфейса.
///   - fonts: Шрифты, используемые в интерфейсе.
///   - elkErrorType: Типы ошибок, используемых в едином личном кабинете.
let preferences = SIDUIPreferences(
    texts: SIDTexts(
          titleError: "titleError", 
          descriptionError: "descriptionError", 
          buttonError: "buttonError"
     ),
    themeColor: SIDColor(
          light: .black, 
          dark: .white
     ),
    primaryColor: SIDColor(
          light: .black, 
          dark: .white
     ),
    secondaryColor: SIDColor(
          light: .black, 
          dark: .white
     ),
    fonts: SIDFonts(
          semiboldFont: UIFont(name: "1stFont", size: 15), 
          mediumFont: UIFont(name: "1stFont", size: 15)
     ),
    elkErrorType: .type1
)
SID.settings.applyUIPreferences(preferences: preferences)

/// При отсутствии значений используются значения по умолчанию.
/// - Parameters:
///   - texts: Тексты, используемые в интерфейсе.
///   - themeColor: Основной цвет темы интерфейса.
///   - primaryColor: Основной цвет элементов интерфейса.
///   - secondaryColor: Вторичный цвет элементов интерфейса.
///   - fonts: Шрифты, используемые в интерфейсе.
///   - elkErrorType: Типы ошибок, используемых в едином личном кабинете.
SIDUIPreferences *preferences = [SIDUIPreferences new];
preferences.texts = [SIDTexts withTitleError:@"Ошибка"
                            descriptionError:@"Описание ошибки"
                                 buttonError:@"Кнопка"];
preferences.themeColor = [SIDColor withLight:[UIColor blackColor] 
                                        dark:[UIColor whiteColor]];
preferences.primaryColor = [SIDColor withLight:[UIColor blackColor] 
                                          dark:[UIColor whiteColor]];
preferences.secondaryColor = [SIDColor withLight:[UIColor blackColor] 
                                            dark:[UIColor whiteColor]];
preferences.fonts = [SIDFonts withSemiboldFont:[UIFont fontWithName:@"HelveticaNeue" 
                                                               size:15]
                                   mediumFont:[UIFont fontWithName:@"HelveticaNeue" 
                                                              size:15]];
preferences.elkErrorType = SidelkErrorType1;

[SID settings applyUIPreferencesWithPreferences:preferences];