Installation and initialization

The AppMetrica library supports several platforms:

Step 1. The library can work with the following dependency managers:

The library supports static and dynamic frameworks for CocoaPods. To enable the library, add the dependency to the project Podfile (example for integrating a static framework):

Static framework
```
pod 'YandexMobileMetrica', '3.3.0'
```

Dynamic framework

pod 'YandexMobileMetrica/Dynamic', '3.3.0'

Note. If the Podfile has the line use_frameworks!, we recommend using the dynamic framework.

To enable the library, add the following dependency to the Cartfile and save the file:

github "yandexmobile/metrica-sdk-ios" ~> 3.3.0

If you don't use these dependency managers

To enable the library, follow these steps:

Download the AppMetrica library.
Add YandexMobileMetrica.framework to the project.
Add the following dependencies: 'SystemConfiguration', 'UIKit', 'Foundation', 'CoreTelephony', 'CoreLocation', 'CoreGraphics', 'AdSupport', 'z', 'sqlite3', 'Security', 'c++', 'SafariServices' (with the Optional setting).
Add -ObjC to Other Linker Flags.

Step 2. Initialize the library in the application:didFinishLaunchingWithOptions: method of your UIApplicationDelegate:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    YMMYandexMetricaConfiguration *configuration = [[YMMYandexMetricaConfiguration alloc] initWithApiKey:API_key];
    [YMMYandexMetrica activateWithConfiguration:configuration];
}

What is the API key?

The API key is a unique application identifier that is issued in the AppMetrica web interface during app registration. Make sure you have entered it correctly.

AppMetrica allows tracking pre-installed apps. To use this feature, you must initialize the library with the extended configuration.

Note. Requirements: deployment target 8.0 and higher.

Step 1. The library can work with the following dependency managers:

The library supports static and dynamic frameworks for CocoaPods. To enable the library, add the dependency to the project Podfile (example for integrating a static framework):

Static framework
```
pod 'YandexMobileMetrica', '3.3.0'
```

Dynamic framework

pod 'YandexMobileMetrica/Dynamic', '3.3.0'

Note. If the Podfile has the line use_frameworks!, we recommend using the dynamic framework.

To enable the library, add the following dependency to the Cartfile and save the file:

github "yandexmobile/metrica-sdk-ios" ~> 3.3.0

If you don't use these dependency managers

To enable the library, follow these steps:

Download the AppMetrica library.
Add YandexMobileMetrica.framework to the project.
Add the following dependencies: 'SystemConfiguration', 'UIKit', 'Foundation', 'CoreTelephony', 'CoreLocation', 'CoreGraphics', 'AdSupport', 'z', 'sqlite3', 'Security', 'c++', 'SafariServices' (with the Optional setting).
Add -ObjC to Other Linker Flags.

Step 2. Initialize the library in the extension's initialize NSExtensionPrincipalClass:

+ (void)initialize 
{
    if ([self class] == [MMSTodayViewController class]) {
        // Initializing the AppMetrica SDK.
        YMMYandexMetricaConfiguration *configuration = [[YMMYandexMetricaConfiguration alloc] initWithApiKey:API_key];
        [YMMYandexMetrica activateWithConfiguration:configuration];
    }
}

What is the API key?

The API key is a unique application identifier that is issued in the AppMetrica web interface during app registration. Make sure you have entered it correctly.

AppMetrica allows tracking pre-installed apps. To use this feature, you must initialize the library with the extended configuration.

Note. Requirements: deployment target 8.0 and higher.

Step 1. The library can work with the following dependency managers:

The library supports static and dynamic frameworks for CocoaPods. To enable the library, add the dependency to the project Podfile (example for integrating a static framework):

Static framework
```
pod 'YandexMobileMetrica', '3.3.0'
```

Dynamic framework

pod 'YandexMobileMetrica/Dynamic', '3.3.0'

Note. If the Podfile has the line use_frameworks!, we recommend using the dynamic framework.

To enable the library, add the following dependency to the Cartfile and save the file:

github "yandexmobile/metrica-sdk-ios" ~> 3.3.0

If you don't use these dependency managers

To enable the library, follow these steps:

Download the AppMetrica library.
Add YandexMobileMetrica.framework to the project.
Add the following dependencies: 'SystemConfiguration', 'UIKit', 'Foundation', 'CoreTelephony', 'CoreLocation', 'CoreGraphics', 'AdSupport', 'z', 'sqlite3', 'Security', 'c++', 'SafariServices' (with the Optional setting).
Add -ObjC to Other Linker Flags.

Step 2. Initialize the library in the extension's initialize Main Entry Point method (there may be multiple activation points):

+ (void)initialize {
    if ([self class] == [MMSInterfaceController class]) {
        // Initializing the AppMetrica SDK.
        YMMYandexMetricaConfiguration *configuration = [[YMMYandexMetricaConfiguration alloc] initWithApiKey:API_key];
        [YMMYandexMetrica activateWithConfiguration:configuration];
    }
}

+ (void)initialize {
    if ([self class] == [MMSNotificationController class]) {
        // Initializing the AppMetrica SDK.
        YMMYandexMetricaConfiguration *configuration = [[YMMYandexMetricaConfiguration alloc] initWithApiKey:API_key];
        [YMMYandexMetrica activateWithConfiguration:configuration];
    }
}

What is the API key?

The API key is a unique application identifier that is issued in the AppMetrica web interface during app registration. Make sure you have entered it correctly.

AppMetrica allows tracking pre-installed apps. To use this feature, you must initialize the library with the extended configuration.

Note. Requirements: deployment target 8.0 and higher.