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

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

AppMetrica SDK поддерживает несколько платформ:

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

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

Чтобы подключить оба фреймворка, добавьте в Podfile проекта зависимость (пример подключения статического фреймворка):

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

    pod 'YandexMobileMetrica', '3.4.1'
  • Динамический фреймворк

    pod 'YandexMobileMetrica/Dynamic', '3.4.1'
Чтобы подключить библиотеку без обработки крэшей, используйте зависимость YandexMobileMetrica/Static/Core или YandexMobileMetrica/Dynamic/Core.
Примечание. Если в Podfile присутствует строка use_frameworks!, рекомендуем использовать динамический фреймворк.
Если вы не используете указанные системы управления зависимостями

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

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

Шаг 2. Импортируйте фреймворк в файл инициализации библиотеки с помощью метода import YandexMobileMetrica.

Шаг 3. Инициализируйте библиотеку в методе applicationdidFinishLaunchingWithOptions UIApplicationDelegate:

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey : Any]? = nil) -> Bool
{
    // Инициализация AppMetrica SDK.
    YMMYandexMetrica.activateWithConfiguration(YMMYandexMetricaConfiguration.init(apiKey: "API key")!)
    return true
}
Что такое API key?

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

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

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