Подключение и инициализация

Библиотека AppMetrica состоит из двух фреймворков: один содержит основную функциональность SDK, другой — обработку крэшей. Если вы не используете обработку крэшей средствами AppMetrica, то подключение только основного фреймворка позволит уменьшить размер приложения.

AppMetrica SDK поддерживает следующие платформы:
  • iOS;
  • iOS Extension;
  • iOS Watch версии 1.x (beta);
  • tvOS.

Шаг 1. Подключение библиотеки

Чтобы подключить библиотеку, используйте способ для соответствующей платформы:

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

Библиотека поддерживает статический и динамический фреймворки для CocoaPods.

Чтобы подключить библиотеку с обработкой крэшей, добавьте в Podfile проекта зависимость:

  • Статический фреймворк

    pod 'YandexMobileMetrica', '3.6.0'

    Пример подключения статического фреймворка на GitHub.

  • Динамический фреймворк

    pod 'YandexMobileMetrica/Dynamic', '3.6.0'

Чтобы подключить библиотеку без обработки крэшей, используйте зависимость YandexMobileMetrica/Static/Core или YandexMobileMetrica/Dynamic/Core.

Примечание. Если в Podfile присутствует строка use_frameworks!, рекомендуем использовать динамический фреймворк.
Если вы не используете указанные системы управления зависимостями

Для подключения библиотеки выполните следующее:

  1. Добавьте YandexMobileMetrica.framework в проект.
  2. (Опционально) Для подключения обработки крэшей добавьте YandexMobileMetricaCrashes.framework.
  3. Добавьте следующие зависимости: 'SystemConfiguration', 'UIKit', 'Foundation', 'CoreTelephony', 'CoreLocation', 'CoreGraphics', 'AdSupport', 'z', 'sqlite3', 'Security', 'c++', 'SafariServices' (с настройкой Optional).
  4. Добавьте -ObjC в Other Linker Flags.

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

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

Инициализируйте библиотеку в методе application(_:didFinishLaunchingWithOptions:) вашего UIApplicationDelegate:

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey : Any]? = nil) -> Bool
{
    // Initializing the AppMetrica SDK.
    let configuration = YMMYandexMetricaConfiguration.init(apiKey: "API_key")
    YMMYandexMetrica.activate(with: configuration!) 
}
Что такое API key?

API key — это уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при добавлении приложения.

Убедитесь, что он указан верно.

AppMetrica позволяет отслеживать предустановленные приложения. Подробнее см. в разделе трекинг предустановленных приложений.

Примечание. Требования: deployment target 8.0 и выше.