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

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

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

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

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

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    // Инициализация AppMetrica SDK.
    YMMYandexMetricaConfiguration *configuration = [[YMMYandexMetricaConfiguration alloc] initWithApiKey:API_key];
    [YMMYandexMetrica activateWithConfiguration:configuration];
}
Что такое API key?
API key — это уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при  добавлении приложения . Убедитесь, что он указан верно.

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

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