Интеграция SDK

Для работы Varioqub SDK подключите и инициализируйте библиотеку AppMetrica для iOS. Подробнее о том, как это можно сделать, читайте в документации AppMetrica SDK.

Требования к приложению:

• iOS, версия 13 и выше.
• Xcode 14.1 и выше.

Общие рекомендации при интеграции

1. При старте новой сессии вызывайте метод activateConfigAndWait(), чтобы получить значения сохраненных флагов.
2. Запускайте fetchConfig в фоне, чтобы выгрузить новые значения флагов с сервера и активировать их при старте следующей сессии.
3. Не рекомендуется вызывать метод activateConfigAndWait() в середине сессии — это может привести к неконсистентному поведению приложения.

Шаг 1. Подключите библиотеку в проект

Библиотека может работать со следующими системами управления зависимостями:

pod 'Varioqub', '~> 0.8'
pod 'VarioqubAppMetricaAdapter', '~> 0.8' # опционально

targets: [
  .target(
    name: "MyTarget",
    dependencies: [
      .product(name: "Varioqub", package: "varioqub-sdk-ios"),
      .product(name: "VarioqubAppMetricaAdapter", package: "varioqub-sdk-appmetrica-adapter-ios"), // опционально
    ]
  )
]
dependencies: [
  .package(url: "https://github.com/appmetrica/varioqub-sdk-ios", "0.8"..<"2.0.0"),
  .package(url: "https://github.com/appmetrica/varioqub-sdk-appmetrica-adapter-ios", "0.8"..<"2.0.0"), // опционально
]

Шаг 2. Инициализируйте библиотеку

Для инициализации библиотеки используется метод

initialize(clientId: String, config: VarioqubConfig = .default, idProvider: VarioqubIdProvider?, reporter: VarioqubReporter?)

В качестве параметров он принимает:

• clientId: String. Идентификатор вашего проекта в формате appmetrica.XXXXXX, где XXXXXX — идентификатор приложения из интерфейса AppMetrica (например, clientId: "appmetrica.1234567").

  Совет

  ID приложения можно получить на странице Настройки AppMetrica: скопируйте его из Общие настройки → ID приложения.

• config: VarioqubConfig. Конфигурация Varioqub по умолчанию. Дополнительно можно передать список пользовательских параметров в clientFeatures. Например, признак того, что пользователь подписан на рассылки.

• idProvider: VarioqubIdProvider. Адаптер для сбора и передачи статистики в аналитическую систему, например, в AppMetrica. Если вы не хотите собирать статистику, передайте nil.

• reporter: VarioqubReporter. Адаптер для сбора и передачи статистики в аналитическую систему, например, в AppMetrica. Если вы не хотите собирать статистику, передайте nil.

  Важно

  reporter хранится как weak ссылка внутри Varioqub. Если вы передаете объект, предусмотрите, чтобы он не уничтожился раньше времени.

  import SwiftUI
  import Varioqub
  import VarioqubAppMetricaAdapter
  
  final class VarioqubInitializer {
      let adapter = AppMetricaAdapter()
  
      static let shared = VarioqubInitializer()
      private init() {
          // Configure Varioqub SDK
          var vqCfg = VarioqubConfig.default
  
          // Add client parameters
          vqCfg.clientFeatures["feature1"] = "value1"
  
          // Initialize Varioqub SDK
          VarioqubFacade.shared.initialize(clientId: "appmetrica.1234567", config: vqCfg, idProvider: adapter, reporter: adapter)
      }
  }
  
  @main
  struct ExampleApp: App {
      init() {
          _ = VarioqubInitializer.shared
      }
  }
  

Конфигурация VarioqubConfig

В конфигурации используются значения по умолчанию.

public struct VarioqubConfig {
    public var baseURL: URL?
    public var settings: VarioqubSettingsProtocol?
    public var network: NetworkRequestCreator?
    public var fetchThrottle: TimeInterval?
    public var clientFeatures: [String: String] = [:]
    public var varioqubQueue: DispatchQueue?
    public var outputQueue: DispatchQueue = .main

    public static var `default`: VarioqubConfig = VarioqubConfig()
}

Дополнительно можно передать:

• clientFeatures — список пользовательских параметров. Например, признак того, что пользователь подписан на рассылки.

  vqCfg.clientFeatures["feature1"] = "value1"
  

• fetchThrottle — ограничение частоты обновления конфига в секундах. Рекомендуется использовать только для тестирования.

  var vqCfg = VarioqubConfig.default
  vqCfg.fetchThrottle = 2 // seconds
  

Шаг 3. Задайте конфигурацию по умолчанию с помощью XML-файла

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

1. Скачайте XML-файл конфигурации со страницы Конфиг флагов и сохраните его в своем Xcode проекте.

2. Передайте загруженный XML-файл конфигурации с помощью метода loadXml.

let path = URL(fileURLWithPath: "/full/path/to/my/file/defaults.xml")
VarioqubFacade.shared.loadXml(at: path, callback: nil)

Шаг 4. Запустите обновление конфигурации флагов в фоне

Чтобы использовать самую свежую конфигурацию флагов из интерфейса, запустите фоновое обновление конфигурации с помощью метода fetchConfig.

VarioqubFacade.shared.fetchConfig({ status in
    switch status {
        case .success: print("success")
        case .throttled, .cached: print("already latest")
        case .error(let e): print("error: \(e)")
    }
})

Шаг 5. Активируйте конфигурацию

Активируйте конфигурацию с помощью метода activateConfigAndWait().

VarioqubFacade.shared.activateConfigAndWait()

Используйте метод activateConfigAndWait() каждый раз, когда необходимо активировать полученную/загруженную конфигурацию (например, при старте новой сессии).

Получение флагов из интерфейса

Значения флагов вычисляются и предоставляются в следующем порядке:

1. Флаг есть в эксперименте.
2. Флаг есть в загруженной конфигурации.
3. Флаг есть в конфигурации по умолчанию.

Методы для получения флагов:

• VarioqubFacade.shared.getString(flag, defaultValue).

Пример кода:

extension VarioqubFlag {
    static let myFlag = VarioqubFlag(rawValue: "myFlag")
}

let flag = VarioqubFacade.shared.getString(flag: .myFlag, defaultValue: "flag_value")

Получение ID устройства для проверки эксперимента

Для получения ID устройства используйте метод VarioqubFacade.varioqubId:

let varioqubId = VarioqubFacade.shared.varioqubId

Подробнее о создании и проверке эксперимента читайте в разделе Создание эксперимента.