Working iOS example

example/ios/YandexMobileMetrica.framework/Headers/YMMVersion.h

@@ -0,0 +1,21 @@
+/*
+ *  YMMVersion.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#ifndef __YMM_VERSION_H__
+#define __YMM_VERSION_H__
+
+#define YMM_VERSION_MAJOR 2
+#define YMM_VERSION_MINOR 9
+#define YMM_VERSION_PATCH 1
+
+#define YMM_BUILD_NUMBER 8517
+
+#endif // __YMM_VERSION_H__

example/ios/YandexMobileMetrica.framework/Headers/YMMYandexMetrica.h

@@ -0,0 +1,171 @@
+/*
+ *  YMMYandexMetrica.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#import <Foundation/Foundation.h>
+
+@class CLLocation;
+@class YMMYandexMetricaConfiguration;
+@protocol YMMYandexMetricaReporting;
+
+NS_ASSUME_NONNULL_BEGIN
+
+extern NSString *const kYMMYandexMetricaErrorDomain;
+
+typedef NS_ENUM(NSInteger, YMMYandexMetricaEventErrorCode) {
+    YMMYandexMetricaEventErrorCodeInitializationError = 1000,
+    YMMYandexMetricaEventErrorCodeInvalidName = 1001,
+    YMMYandexMetricaEventErrorCodeJsonSerializationError = 1002,
+};
+
+@interface YMMYandexMetrica : NSObject
+
+/** Starting the statistics collection process.
+
+ @param apiKey Application key that is issued during application registration in AppMetrica.
+ Application key must be a hexadecimal string in format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+ The key can be requested or checked at https://appmetrica.yandex.com
+ */
++ (void)activateWithApiKey:(NSString *)apiKey;
+
+/** Starting the statistics collection process.
+
+ @param configuration Configuration combines all AppMetrica settings in one place.
+ Configuration initialized with unique application key that is issued during application registration in AppMetrica.
+ Application key must be a hexadecimal string in format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+ The key can be requested or checked at https://appmetrica.yandex.com
+ */
++ (void)activateWithConfiguration:(YMMYandexMetricaConfiguration *)configuration;
+
+/** Reporting custom event.
+
+ @param message Short name or description of the event.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
++ (void)reportEvent:(NSString *)message
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Reporting custom event with additional parameters.
+
+ @param message Short name or description of the event.
+ @param params Dictionary of name/value pairs that should be sent to the server.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
++ (void)reportEvent:(NSString *)message
+         parameters:(nullable NSDictionary *)params
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Reporting custom error messages.
+
+ @param message Short name or description of the error
+ @param exception Exception contains an NSException object that must be passed to the server. It can take the nil value.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
++ (void)reportError:(NSString *)message
+          exception:(nullable NSException *)exception
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Enable/disable location reporting to AppMetrica.
+ If enabled and location set via setLocation: method - that location would be used.
+ If enabled and location is not set via setLocation,
+ but application has appropriate permission - CLLocationManager would be used to acquire location data.
+ 
+ @param enabled Flag indicating if reporting location to AppMetrica enabled
+ Enabled by default.
+ */
++ (void)setTrackLocationEnabled:(BOOL)enabled;
+
+/** Set location to AppMetrica
+ To enable AppMetrica to use this location trackLocationEnabled should be 'YES'
+ 
+ @param location Custom device location to be reported.
+ */
++ (void)setLocation:(nullable CLLocation *)location;
+
+/** Setting session timeout (in seconds).
+
+ @param sessionTimeoutSeconds Time limit before the application is considered inactive.
+ By default, the session times out if the application is in background for 10 seconds.
+ Minimum accepted value is 10 seconds. All passed values below 10 seconds automatically become 10 seconds.
+ */
++ (void)setSessionTimeout:(NSUInteger)sessionTimeoutSeconds;
+
+/** Tracking app crashes.
+
+ @param enabled Boolean value to enable or disable collecting and sending crash reports.
+ By default, reports on application crashes are sent, meaning enabled=true.
+ To disable crash tracking, set the parameter value to enabled=false.
+ */
++ (void)setReportCrashesEnabled:(BOOL)enabled;
+
+/** Setting the arbitrary application version.
+
+ @param appVersion Application version to be reported.
+ By default, the application version is set in the app configuration file Info.plist (CFBundleShortVersionString).
+ */
++ (void)setCustomAppVersion:(NSString *)appVersion;
+
+/** Enable or disable logging.
+
+ @param isEnabled Boolean value to enable or disable logging. By default logging is disabled.
+ */
++ (void)setLoggingEnabled:(BOOL)isEnabled;
+
+/** Setting key - value data to be used as additional information, associated with future unhandled exception.
+ If value is nil, previously set key-value is removed. Does nothing if key hasn't been added.
+
+ @param value The error environment value.
+ @param key The error environment key.
+ */
++ (void)setEnvironmentValue:(nullable NSString *)value forKey:(NSString *)key;
+
+/** Retrieves current version of library.
+ */
++ (NSString *)libraryVersion;
+
+/** Enables AppMetrica's tracking mechanism by providing application's url scheme.
+
+ @param urlScheme Application's deep link scheme. Scheme should be registered in CFBundleURLTypes Info.plist section.
+ */
++ (BOOL)enableTrackingWithURLScheme:(NSURL *)urlScheme NS_EXTENSION_UNAVAILABLE_IOS("") NS_AVAILABLE_IOS(9_0);
+
+/** Handles the URL that has opened the application.
+ Reports the URL for deep links tracking.
+ URL scheme should be registered beforehand via `enableTrackingWithUrlScheme:` method for tracking to work correctly.
+
+ @param url URL that has opened the application.
+ */
++ (BOOL)handleOpenURL:(NSURL *)url;
+
+/** Returns id<YMMYandexMetricaReporting> that can send events to specific API key.
+
+ @param apiKey Api key to send events to.
+ @return id<YMMYandexMetricaReporting> that conforms to YMMYandexMetricaReporting and handles 
+ sending events to specified apikey
+ */
++ (nullable id<YMMYandexMetricaReporting>)reporterForApiKey:(NSString *)apiKey;
+
+/**
+ * Sets referral URL for this installation. This might be required to track some specific traffic sources like Facebook.
+ * @param url referral URL value.
+ */
++ (void)reportReferralUrl:(NSURL *)url;
+
+@end
+
+@interface YMMYandexMetrica (YMMYandexMetricaDeprecatedOrUnavailable)
+
++ (void)startWithAPIKey:(NSString *)apiKey
+    __attribute__((unavailable("WARNING: apiKey used in startWithAPIKey isn't compatible with activateWithApiKey:. "
+                               "Use activateWithApiKey: with updated key. More info in activateWithApiKey:'s description")));
+
+@end
+
+NS_ASSUME_NONNULL_END

example/ios/YandexMobileMetrica.framework/Headers/YMMYandexMetricaConfiguration.h

@@ -0,0 +1,96 @@
+/*
+ *  YMMYandexMetricaConfiguration.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#import <Foundation/Foundation.h>
+
+@class CLLocation;
+@class YMMYandexMetricaPreloadInfo;
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface YMMYandexMetricaConfiguration : NSObject
+
+/** Initialize configuration with specified Application key.
+ For invalid Application initialization returns nil in release and raises an exception in debug.
+
+ @param apiKey Application key that is issued during application registration in AppMetrica.
+ Application key must be a hexadecimal string in format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+ The key can be requested or checked at https://appmetrica.yandex.com
+ */
+- (nullable instancetype)initWithApiKey:(NSString *)apiKey;
+
+- (instancetype)init __attribute__((unavailable("initWithApiKey: must be used instead.")));
+
+/** Get Application key used to initialize the configuration.
+ */
+@property (nonatomic, copy, readonly) NSString *apiKey;
+
+/** Whether first activation of AppMetrica should be considered as app update or new app install.
+ If this option is enabled the first call of +[YMMYandexMetrica activateWithApiKey:] or
+ +[YMMYandexMetrica activateWithConfiguration:] will be considered as an application update.
+
+ By default this option is disabled.
+ */
+@property (nonatomic, assign) BOOL handleFirstActivationAsUpdateEnabled;
+
+/** Enable/disable location reporting to AppMetrica.
+ If enabled and location set via setLocation: method - that location would be used.
+ If enabled and location is not set via setLocation,
+ but application has appropriate permission - CLLocationManager would be used to acquire location data.
+
+ Enabled by default.
+ */
+@property (nonatomic, assign) BOOL trackLocationEnabled;
+
+/** Set/get location to AppMetrica
+ To enable AppMetrica to use this location trackLocationEnabled should be 'YES'
+
+ By default is nil
+ */
+@property (nonatomic, strong, nullable) CLLocation *location;
+
+/** Set/get session timeout (in seconds).
+ Time limit before the application is considered inactive.
+ Minimum accepted value is 10 seconds. All passed values below 10 seconds automatically become 10 seconds.
+
+ By default, the session times out if the application is in background for 10 seconds.
+ */
+@property (nonatomic, assign) NSUInteger sessionTimeout;
+
+/** Enable/disable tracking app crashes.
+
+ Enabled by default.
+ To disable crash tracking, set the parameter value to false.
+ */
+@property (nonatomic, assign) BOOL reportCrashesEnabled;
+
+/** Set/get the arbitrary application version for AppMetrica to report.
+
+ By default, the application version is set in the app configuration file Info.plist (CFBundleShortVersionString).
+ */
+@property (nonatomic, copy, nullable) NSString *customAppVersion;
+
+/** Enable/disable logging.
+
+ By default logging is disabled.
+ */
+@property (nonatomic, assign) BOOL loggingEnabled;
+
+/** Set/get preload info, which is used for tracking preload installs.
+ Additional info could be https://appmetrica.yandex.com
+
+ By default is nil.
+ */
+@property (nonatomic, copy, nullable) YMMYandexMetricaPreloadInfo *preloadInfo;
+
+@end
+
+NS_ASSUME_NONNULL_END

example/ios/YandexMobileMetrica.framework/Headers/YMMYandexMetricaPreloadInfo.h

@@ -0,0 +1,36 @@
+/*
+ *  YMMYandexMetricaPreloadInfo.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface YMMYandexMetricaPreloadInfo : NSObject <NSCopying>
+
+- (instancetype)init __attribute__((unavailable("initWithTrackingIdentifier: must be used instead.")));
+
+/** Initialize Preload info with specific publisher and tracking identifiers.
+ If case of invalid identifiers constructor returns nil in release and raises an exception in debug
+
+ @param trackingID Tracking identifier
+ */
+- (nullable instancetype)initWithTrackingIdentifier:(NSString *)trackingID;
+
+/** Setting key - value data to be used as additional information, associated with preload info.
+
+ @param info Additional preload info.
+ @param key Additional preload key.
+ */
+- (void)setAdditionalInfo:(NSString *)info forKey:(NSString *)key;
+
+@end
+
+NS_ASSUME_NONNULL_END

example/ios/YandexMobileMetrica.framework/Headers/YMMYandexMetricaReporting.h

@@ -0,0 +1,61 @@
+/*
+ *  YMMYandexMetricaReporting.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/** YMMYandexMetricaReporting protocol groups methods that are used by custom reporting objects.
+ */
+@protocol YMMYandexMetricaReporting <NSObject>
+
+/** Reporting custom event.
+
+ @param name Short name or description of the event.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
+- (void)reportEvent:(NSString *)name
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Reporting custom event with additional parameters.
+
+ @param name Short name or description of the event.
+ @param params Dictionary of name/value pairs that must be sent to the server.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
+- (void)reportEvent:(NSString *)name
+         parameters:(nullable NSDictionary *)params
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Reporting custom error messages.
+
+ @param name Short name or description of the error.
+ @param exception NSException object that must be sent to the server.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
+- (void)reportError:(NSString *)name
+          exception:(nullable NSException *)exception
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Resumes last session or creates a new one if it has been expired.
+ Should be used when auto tracking of application state is unavailable or is different.
+ */
+- (void)resumeSession;
+
+/** Pause current session.
+ All events reported after calling this method and till the session timeout will still join this session.
+ Should be used when auto tracking of application state is unavailable or is different.
+ */
+- (void)pauseSession;
+
+@end
+
+NS_ASSUME_NONNULL_END

example/ios/YandexMobileMetrica.framework/Headers/YandexMobileMetrica.h

@@ -0,0 +1,24 @@
+/*
+ *  YandexMobileMetrica.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#if __has_include("YMMYandexMetrica.h")
+    #import "YMMYandexMetrica.h"
+    #import "YMMVersion.h"
+    #import "YMMYandexMetricaConfiguration.h"
+    #import "YMMYandexMetricaReporting.h"
+    #import "YMMYandexMetricaPreloadInfo.h"
+#else
+    #import <YandexMobileMetrica/YMMYandexMetrica.h>
+    #import <YandexMobileMetrica/YMMVersion.h>
+    #import <YandexMobileMetrica/YMMYandexMetricaConfiguration.h>
+    #import <YandexMobileMetrica/YMMYandexMetricaReporting.h>
+    #import <YandexMobileMetrica/YMMYandexMetricaPreloadInfo.h>
+#endif

example/ios/YandexMobileMetrica.framework/Modules/module.modulemap

@@ -0,0 +1,6 @@
+framework module YandexMobileMetrica {
+  umbrella header "YandexMobileMetrica.h"
+
+  export *
+  module * { export * }
+}

example/ios/YandexMobileMetrica.framework/Versions/A/Headers/YMMVersion.h

@@ -0,0 +1,21 @@
+/*
+ *  YMMVersion.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#ifndef __YMM_VERSION_H__
+#define __YMM_VERSION_H__
+
+#define YMM_VERSION_MAJOR 2
+#define YMM_VERSION_MINOR 9
+#define YMM_VERSION_PATCH 1
+
+#define YMM_BUILD_NUMBER 8517
+
+#endif // __YMM_VERSION_H__

example/ios/YandexMobileMetrica.framework/Versions/A/Headers/YMMYandexMetrica.h

@@ -0,0 +1,171 @@
+/*
+ *  YMMYandexMetrica.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#import <Foundation/Foundation.h>
+
+@class CLLocation;
+@class YMMYandexMetricaConfiguration;
+@protocol YMMYandexMetricaReporting;
+
+NS_ASSUME_NONNULL_BEGIN
+
+extern NSString *const kYMMYandexMetricaErrorDomain;
+
+typedef NS_ENUM(NSInteger, YMMYandexMetricaEventErrorCode) {
+    YMMYandexMetricaEventErrorCodeInitializationError = 1000,
+    YMMYandexMetricaEventErrorCodeInvalidName = 1001,
+    YMMYandexMetricaEventErrorCodeJsonSerializationError = 1002,
+};
+
+@interface YMMYandexMetrica : NSObject
+
+/** Starting the statistics collection process.
+
+ @param apiKey Application key that is issued during application registration in AppMetrica.
+ Application key must be a hexadecimal string in format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+ The key can be requested or checked at https://appmetrica.yandex.com
+ */
++ (void)activateWithApiKey:(NSString *)apiKey;
+
+/** Starting the statistics collection process.
+
+ @param configuration Configuration combines all AppMetrica settings in one place.
+ Configuration initialized with unique application key that is issued during application registration in AppMetrica.
+ Application key must be a hexadecimal string in format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+ The key can be requested or checked at https://appmetrica.yandex.com
+ */
++ (void)activateWithConfiguration:(YMMYandexMetricaConfiguration *)configuration;
+
+/** Reporting custom event.
+
+ @param message Short name or description of the event.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
++ (void)reportEvent:(NSString *)message
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Reporting custom event with additional parameters.
+
+ @param message Short name or description of the event.
+ @param params Dictionary of name/value pairs that should be sent to the server.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
++ (void)reportEvent:(NSString *)message
+         parameters:(nullable NSDictionary *)params
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Reporting custom error messages.
+
+ @param message Short name or description of the error
+ @param exception Exception contains an NSException object that must be passed to the server. It can take the nil value.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
++ (void)reportError:(NSString *)message
+          exception:(nullable NSException *)exception
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Enable/disable location reporting to AppMetrica.
+ If enabled and location set via setLocation: method - that location would be used.
+ If enabled and location is not set via setLocation,
+ but application has appropriate permission - CLLocationManager would be used to acquire location data.
+ 
+ @param enabled Flag indicating if reporting location to AppMetrica enabled
+ Enabled by default.
+ */
++ (void)setTrackLocationEnabled:(BOOL)enabled;
+
+/** Set location to AppMetrica
+ To enable AppMetrica to use this location trackLocationEnabled should be 'YES'
+ 
+ @param location Custom device location to be reported.
+ */
++ (void)setLocation:(nullable CLLocation *)location;
+
+/** Setting session timeout (in seconds).
+
+ @param sessionTimeoutSeconds Time limit before the application is considered inactive.
+ By default, the session times out if the application is in background for 10 seconds.
+ Minimum accepted value is 10 seconds. All passed values below 10 seconds automatically become 10 seconds.
+ */
++ (void)setSessionTimeout:(NSUInteger)sessionTimeoutSeconds;
+
+/** Tracking app crashes.
+
+ @param enabled Boolean value to enable or disable collecting and sending crash reports.
+ By default, reports on application crashes are sent, meaning enabled=true.
+ To disable crash tracking, set the parameter value to enabled=false.
+ */
++ (void)setReportCrashesEnabled:(BOOL)enabled;
+
+/** Setting the arbitrary application version.
+
+ @param appVersion Application version to be reported.
+ By default, the application version is set in the app configuration file Info.plist (CFBundleShortVersionString).
+ */
++ (void)setCustomAppVersion:(NSString *)appVersion;
+
+/** Enable or disable logging.
+
+ @param isEnabled Boolean value to enable or disable logging. By default logging is disabled.
+ */
++ (void)setLoggingEnabled:(BOOL)isEnabled;
+
+/** Setting key - value data to be used as additional information, associated with future unhandled exception.
+ If value is nil, previously set key-value is removed. Does nothing if key hasn't been added.
+
+ @param value The error environment value.
+ @param key The error environment key.
+ */
++ (void)setEnvironmentValue:(nullable NSString *)value forKey:(NSString *)key;
+
+/** Retrieves current version of library.
+ */
++ (NSString *)libraryVersion;
+
+/** Enables AppMetrica's tracking mechanism by providing application's url scheme.
+
+ @param urlScheme Application's deep link scheme. Scheme should be registered in CFBundleURLTypes Info.plist section.
+ */
++ (BOOL)enableTrackingWithURLScheme:(NSURL *)urlScheme NS_EXTENSION_UNAVAILABLE_IOS("") NS_AVAILABLE_IOS(9_0);
+
+/** Handles the URL that has opened the application.
+ Reports the URL for deep links tracking.
+ URL scheme should be registered beforehand via `enableTrackingWithUrlScheme:` method for tracking to work correctly.
+
+ @param url URL that has opened the application.
+ */
++ (BOOL)handleOpenURL:(NSURL *)url;
+
+/** Returns id<YMMYandexMetricaReporting> that can send events to specific API key.
+
+ @param apiKey Api key to send events to.
+ @return id<YMMYandexMetricaReporting> that conforms to YMMYandexMetricaReporting and handles 
+ sending events to specified apikey
+ */
++ (nullable id<YMMYandexMetricaReporting>)reporterForApiKey:(NSString *)apiKey;
+
+/**
+ * Sets referral URL for this installation. This might be required to track some specific traffic sources like Facebook.
+ * @param url referral URL value.
+ */
++ (void)reportReferralUrl:(NSURL *)url;
+
+@end
+
+@interface YMMYandexMetrica (YMMYandexMetricaDeprecatedOrUnavailable)
+
++ (void)startWithAPIKey:(NSString *)apiKey
+    __attribute__((unavailable("WARNING: apiKey used in startWithAPIKey isn't compatible with activateWithApiKey:. "
+                               "Use activateWithApiKey: with updated key. More info in activateWithApiKey:'s description")));
+
+@end
+
+NS_ASSUME_NONNULL_END

example/ios/YandexMobileMetrica.framework/Versions/A/Headers/YMMYandexMetricaConfiguration.h

@@ -0,0 +1,96 @@
+/*
+ *  YMMYandexMetricaConfiguration.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#import <Foundation/Foundation.h>
+
+@class CLLocation;
+@class YMMYandexMetricaPreloadInfo;
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface YMMYandexMetricaConfiguration : NSObject
+
+/** Initialize configuration with specified Application key.
+ For invalid Application initialization returns nil in release and raises an exception in debug.
+
+ @param apiKey Application key that is issued during application registration in AppMetrica.
+ Application key must be a hexadecimal string in format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+ The key can be requested or checked at https://appmetrica.yandex.com
+ */
+- (nullable instancetype)initWithApiKey:(NSString *)apiKey;
+
+- (instancetype)init __attribute__((unavailable("initWithApiKey: must be used instead.")));
+
+/** Get Application key used to initialize the configuration.
+ */
+@property (nonatomic, copy, readonly) NSString *apiKey;
+
+/** Whether first activation of AppMetrica should be considered as app update or new app install.
+ If this option is enabled the first call of +[YMMYandexMetrica activateWithApiKey:] or
+ +[YMMYandexMetrica activateWithConfiguration:] will be considered as an application update.
+
+ By default this option is disabled.
+ */
+@property (nonatomic, assign) BOOL handleFirstActivationAsUpdateEnabled;
+
+/** Enable/disable location reporting to AppMetrica.
+ If enabled and location set via setLocation: method - that location would be used.
+ If enabled and location is not set via setLocation,
+ but application has appropriate permission - CLLocationManager would be used to acquire location data.
+
+ Enabled by default.
+ */
+@property (nonatomic, assign) BOOL trackLocationEnabled;
+
+/** Set/get location to AppMetrica
+ To enable AppMetrica to use this location trackLocationEnabled should be 'YES'
+
+ By default is nil
+ */
+@property (nonatomic, strong, nullable) CLLocation *location;
+
+/** Set/get session timeout (in seconds).
+ Time limit before the application is considered inactive.
+ Minimum accepted value is 10 seconds. All passed values below 10 seconds automatically become 10 seconds.
+
+ By default, the session times out if the application is in background for 10 seconds.
+ */
+@property (nonatomic, assign) NSUInteger sessionTimeout;
+
+/** Enable/disable tracking app crashes.
+
+ Enabled by default.
+ To disable crash tracking, set the parameter value to false.
+ */
+@property (nonatomic, assign) BOOL reportCrashesEnabled;
+
+/** Set/get the arbitrary application version for AppMetrica to report.
+
+ By default, the application version is set in the app configuration file Info.plist (CFBundleShortVersionString).
+ */
+@property (nonatomic, copy, nullable) NSString *customAppVersion;
+
+/** Enable/disable logging.
+
+ By default logging is disabled.
+ */
+@property (nonatomic, assign) BOOL loggingEnabled;
+
+/** Set/get preload info, which is used for tracking preload installs.
+ Additional info could be https://appmetrica.yandex.com
+
+ By default is nil.
+ */
+@property (nonatomic, copy, nullable) YMMYandexMetricaPreloadInfo *preloadInfo;
+
+@end
+
+NS_ASSUME_NONNULL_END

example/ios/YandexMobileMetrica.framework/Versions/A/Headers/YMMYandexMetricaPreloadInfo.h

@@ -0,0 +1,36 @@
+/*
+ *  YMMYandexMetricaPreloadInfo.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface YMMYandexMetricaPreloadInfo : NSObject <NSCopying>
+
+- (instancetype)init __attribute__((unavailable("initWithTrackingIdentifier: must be used instead.")));
+
+/** Initialize Preload info with specific publisher and tracking identifiers.
+ If case of invalid identifiers constructor returns nil in release and raises an exception in debug
+
+ @param trackingID Tracking identifier
+ */
+- (nullable instancetype)initWithTrackingIdentifier:(NSString *)trackingID;
+
+/** Setting key - value data to be used as additional information, associated with preload info.
+
+ @param info Additional preload info.
+ @param key Additional preload key.
+ */
+- (void)setAdditionalInfo:(NSString *)info forKey:(NSString *)key;
+
+@end
+
+NS_ASSUME_NONNULL_END

example/ios/YandexMobileMetrica.framework/Versions/A/Headers/YMMYandexMetricaReporting.h

@@ -0,0 +1,61 @@
+/*
+ *  YMMYandexMetricaReporting.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/** YMMYandexMetricaReporting protocol groups methods that are used by custom reporting objects.
+ */
+@protocol YMMYandexMetricaReporting <NSObject>
+
+/** Reporting custom event.
+
+ @param name Short name or description of the event.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
+- (void)reportEvent:(NSString *)name
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Reporting custom event with additional parameters.
+
+ @param name Short name or description of the event.
+ @param params Dictionary of name/value pairs that must be sent to the server.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
+- (void)reportEvent:(NSString *)name
+         parameters:(nullable NSDictionary *)params
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Reporting custom error messages.
+
+ @param name Short name or description of the error.
+ @param exception NSException object that must be sent to the server.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
+- (void)reportError:(NSString *)name
+          exception:(nullable NSException *)exception
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Resumes last session or creates a new one if it has been expired.
+ Should be used when auto tracking of application state is unavailable or is different.
+ */
+- (void)resumeSession;
+
+/** Pause current session.
+ All events reported after calling this method and till the session timeout will still join this session.
+ Should be used when auto tracking of application state is unavailable or is different.
+ */
+- (void)pauseSession;
+
+@end
+
+NS_ASSUME_NONNULL_END

example/ios/YandexMobileMetrica.framework/Versions/A/Headers/YandexMobileMetrica.h

@@ -0,0 +1,24 @@
+/*
+ *  YandexMobileMetrica.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#if __has_include("YMMYandexMetrica.h")
+    #import "YMMYandexMetrica.h"
+    #import "YMMVersion.h"
+    #import "YMMYandexMetricaConfiguration.h"
+    #import "YMMYandexMetricaReporting.h"
+    #import "YMMYandexMetricaPreloadInfo.h"
+#else
+    #import <YandexMobileMetrica/YMMYandexMetrica.h>
+    #import <YandexMobileMetrica/YMMVersion.h>
+    #import <YandexMobileMetrica/YMMYandexMetricaConfiguration.h>
+    #import <YandexMobileMetrica/YMMYandexMetricaReporting.h>
+    #import <YandexMobileMetrica/YMMYandexMetricaPreloadInfo.h>
+#endif

example/ios/YandexMobileMetrica.framework/Versions/Current/Headers/YMMVersion.h

@@ -0,0 +1,21 @@
+/*
+ *  YMMVersion.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#ifndef __YMM_VERSION_H__
+#define __YMM_VERSION_H__
+
+#define YMM_VERSION_MAJOR 2
+#define YMM_VERSION_MINOR 9
+#define YMM_VERSION_PATCH 1
+
+#define YMM_BUILD_NUMBER 8517
+
+#endif // __YMM_VERSION_H__

example/ios/YandexMobileMetrica.framework/Versions/Current/Headers/YMMYandexMetrica.h

@@ -0,0 +1,171 @@
+/*
+ *  YMMYandexMetrica.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#import <Foundation/Foundation.h>
+
+@class CLLocation;
+@class YMMYandexMetricaConfiguration;
+@protocol YMMYandexMetricaReporting;
+
+NS_ASSUME_NONNULL_BEGIN
+
+extern NSString *const kYMMYandexMetricaErrorDomain;
+
+typedef NS_ENUM(NSInteger, YMMYandexMetricaEventErrorCode) {
+    YMMYandexMetricaEventErrorCodeInitializationError = 1000,
+    YMMYandexMetricaEventErrorCodeInvalidName = 1001,
+    YMMYandexMetricaEventErrorCodeJsonSerializationError = 1002,
+};
+
+@interface YMMYandexMetrica : NSObject
+
+/** Starting the statistics collection process.
+
+ @param apiKey Application key that is issued during application registration in AppMetrica.
+ Application key must be a hexadecimal string in format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+ The key can be requested or checked at https://appmetrica.yandex.com
+ */
++ (void)activateWithApiKey:(NSString *)apiKey;
+
+/** Starting the statistics collection process.
+
+ @param configuration Configuration combines all AppMetrica settings in one place.
+ Configuration initialized with unique application key that is issued during application registration in AppMetrica.
+ Application key must be a hexadecimal string in format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+ The key can be requested or checked at https://appmetrica.yandex.com
+ */
++ (void)activateWithConfiguration:(YMMYandexMetricaConfiguration *)configuration;
+
+/** Reporting custom event.
+
+ @param message Short name or description of the event.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
++ (void)reportEvent:(NSString *)message
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Reporting custom event with additional parameters.
+
+ @param message Short name or description of the event.
+ @param params Dictionary of name/value pairs that should be sent to the server.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
++ (void)reportEvent:(NSString *)message
+         parameters:(nullable NSDictionary *)params
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Reporting custom error messages.
+
+ @param message Short name or description of the error
+ @param exception Exception contains an NSException object that must be passed to the server. It can take the nil value.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
++ (void)reportError:(NSString *)message
+          exception:(nullable NSException *)exception
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Enable/disable location reporting to AppMetrica.
+ If enabled and location set via setLocation: method - that location would be used.
+ If enabled and location is not set via setLocation,
+ but application has appropriate permission - CLLocationManager would be used to acquire location data.
+ 
+ @param enabled Flag indicating if reporting location to AppMetrica enabled
+ Enabled by default.
+ */
++ (void)setTrackLocationEnabled:(BOOL)enabled;
+
+/** Set location to AppMetrica
+ To enable AppMetrica to use this location trackLocationEnabled should be 'YES'
+ 
+ @param location Custom device location to be reported.
+ */
++ (void)setLocation:(nullable CLLocation *)location;
+
+/** Setting session timeout (in seconds).
+
+ @param sessionTimeoutSeconds Time limit before the application is considered inactive.
+ By default, the session times out if the application is in background for 10 seconds.
+ Minimum accepted value is 10 seconds. All passed values below 10 seconds automatically become 10 seconds.
+ */
++ (void)setSessionTimeout:(NSUInteger)sessionTimeoutSeconds;
+
+/** Tracking app crashes.
+
+ @param enabled Boolean value to enable or disable collecting and sending crash reports.
+ By default, reports on application crashes are sent, meaning enabled=true.
+ To disable crash tracking, set the parameter value to enabled=false.
+ */
++ (void)setReportCrashesEnabled:(BOOL)enabled;
+
+/** Setting the arbitrary application version.
+
+ @param appVersion Application version to be reported.
+ By default, the application version is set in the app configuration file Info.plist (CFBundleShortVersionString).
+ */
++ (void)setCustomAppVersion:(NSString *)appVersion;
+
+/** Enable or disable logging.
+
+ @param isEnabled Boolean value to enable or disable logging. By default logging is disabled.
+ */
++ (void)setLoggingEnabled:(BOOL)isEnabled;
+
+/** Setting key - value data to be used as additional information, associated with future unhandled exception.
+ If value is nil, previously set key-value is removed. Does nothing if key hasn't been added.
+
+ @param value The error environment value.
+ @param key The error environment key.
+ */
++ (void)setEnvironmentValue:(nullable NSString *)value forKey:(NSString *)key;
+
+/** Retrieves current version of library.
+ */
++ (NSString *)libraryVersion;
+
+/** Enables AppMetrica's tracking mechanism by providing application's url scheme.
+
+ @param urlScheme Application's deep link scheme. Scheme should be registered in CFBundleURLTypes Info.plist section.
+ */
++ (BOOL)enableTrackingWithURLScheme:(NSURL *)urlScheme NS_EXTENSION_UNAVAILABLE_IOS("") NS_AVAILABLE_IOS(9_0);
+
+/** Handles the URL that has opened the application.
+ Reports the URL for deep links tracking.
+ URL scheme should be registered beforehand via `enableTrackingWithUrlScheme:` method for tracking to work correctly.
+
+ @param url URL that has opened the application.
+ */
++ (BOOL)handleOpenURL:(NSURL *)url;
+
+/** Returns id<YMMYandexMetricaReporting> that can send events to specific API key.
+
+ @param apiKey Api key to send events to.
+ @return id<YMMYandexMetricaReporting> that conforms to YMMYandexMetricaReporting and handles 
+ sending events to specified apikey
+ */
++ (nullable id<YMMYandexMetricaReporting>)reporterForApiKey:(NSString *)apiKey;
+
+/**
+ * Sets referral URL for this installation. This might be required to track some specific traffic sources like Facebook.
+ * @param url referral URL value.
+ */
++ (void)reportReferralUrl:(NSURL *)url;
+
+@end
+
+@interface YMMYandexMetrica (YMMYandexMetricaDeprecatedOrUnavailable)
+
++ (void)startWithAPIKey:(NSString *)apiKey
+    __attribute__((unavailable("WARNING: apiKey used in startWithAPIKey isn't compatible with activateWithApiKey:. "
+                               "Use activateWithApiKey: with updated key. More info in activateWithApiKey:'s description")));
+
+@end
+
+NS_ASSUME_NONNULL_END

example/ios/YandexMobileMetrica.framework/Versions/Current/Headers/YMMYandexMetricaConfiguration.h

@@ -0,0 +1,96 @@
+/*
+ *  YMMYandexMetricaConfiguration.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#import <Foundation/Foundation.h>
+
+@class CLLocation;
+@class YMMYandexMetricaPreloadInfo;
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface YMMYandexMetricaConfiguration : NSObject
+
+/** Initialize configuration with specified Application key.
+ For invalid Application initialization returns nil in release and raises an exception in debug.
+
+ @param apiKey Application key that is issued during application registration in AppMetrica.
+ Application key must be a hexadecimal string in format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+ The key can be requested or checked at https://appmetrica.yandex.com
+ */
+- (nullable instancetype)initWithApiKey:(NSString *)apiKey;
+
+- (instancetype)init __attribute__((unavailable("initWithApiKey: must be used instead.")));
+
+/** Get Application key used to initialize the configuration.
+ */
+@property (nonatomic, copy, readonly) NSString *apiKey;
+
+/** Whether first activation of AppMetrica should be considered as app update or new app install.
+ If this option is enabled the first call of +[YMMYandexMetrica activateWithApiKey:] or
+ +[YMMYandexMetrica activateWithConfiguration:] will be considered as an application update.
+
+ By default this option is disabled.
+ */
+@property (nonatomic, assign) BOOL handleFirstActivationAsUpdateEnabled;
+
+/** Enable/disable location reporting to AppMetrica.
+ If enabled and location set via setLocation: method - that location would be used.
+ If enabled and location is not set via setLocation,
+ but application has appropriate permission - CLLocationManager would be used to acquire location data.
+
+ Enabled by default.
+ */
+@property (nonatomic, assign) BOOL trackLocationEnabled;
+
+/** Set/get location to AppMetrica
+ To enable AppMetrica to use this location trackLocationEnabled should be 'YES'
+
+ By default is nil
+ */
+@property (nonatomic, strong, nullable) CLLocation *location;
+
+/** Set/get session timeout (in seconds).
+ Time limit before the application is considered inactive.
+ Minimum accepted value is 10 seconds. All passed values below 10 seconds automatically become 10 seconds.
+
+ By default, the session times out if the application is in background for 10 seconds.
+ */
+@property (nonatomic, assign) NSUInteger sessionTimeout;
+
+/** Enable/disable tracking app crashes.
+
+ Enabled by default.
+ To disable crash tracking, set the parameter value to false.
+ */
+@property (nonatomic, assign) BOOL reportCrashesEnabled;
+
+/** Set/get the arbitrary application version for AppMetrica to report.
+
+ By default, the application version is set in the app configuration file Info.plist (CFBundleShortVersionString).
+ */
+@property (nonatomic, copy, nullable) NSString *customAppVersion;
+
+/** Enable/disable logging.
+
+ By default logging is disabled.
+ */
+@property (nonatomic, assign) BOOL loggingEnabled;
+
+/** Set/get preload info, which is used for tracking preload installs.
+ Additional info could be https://appmetrica.yandex.com
+
+ By default is nil.
+ */
+@property (nonatomic, copy, nullable) YMMYandexMetricaPreloadInfo *preloadInfo;
+
+@end
+
+NS_ASSUME_NONNULL_END

example/ios/YandexMobileMetrica.framework/Versions/Current/Headers/YMMYandexMetricaPreloadInfo.h

@@ -0,0 +1,36 @@
+/*
+ *  YMMYandexMetricaPreloadInfo.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface YMMYandexMetricaPreloadInfo : NSObject <NSCopying>
+
+- (instancetype)init __attribute__((unavailable("initWithTrackingIdentifier: must be used instead.")));
+
+/** Initialize Preload info with specific publisher and tracking identifiers.
+ If case of invalid identifiers constructor returns nil in release and raises an exception in debug
+
+ @param trackingID Tracking identifier
+ */
+- (nullable instancetype)initWithTrackingIdentifier:(NSString *)trackingID;
+
+/** Setting key - value data to be used as additional information, associated with preload info.
+
+ @param info Additional preload info.
+ @param key Additional preload key.
+ */
+- (void)setAdditionalInfo:(NSString *)info forKey:(NSString *)key;
+
+@end
+
+NS_ASSUME_NONNULL_END

example/ios/YandexMobileMetrica.framework/Versions/Current/Headers/YMMYandexMetricaReporting.h

@@ -0,0 +1,61 @@
+/*
+ *  YMMYandexMetricaReporting.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/** YMMYandexMetricaReporting protocol groups methods that are used by custom reporting objects.
+ */
+@protocol YMMYandexMetricaReporting <NSObject>
+
+/** Reporting custom event.
+
+ @param name Short name or description of the event.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
+- (void)reportEvent:(NSString *)name
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Reporting custom event with additional parameters.
+
+ @param name Short name or description of the event.
+ @param params Dictionary of name/value pairs that must be sent to the server.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
+- (void)reportEvent:(NSString *)name
+         parameters:(nullable NSDictionary *)params
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Reporting custom error messages.
+
+ @param name Short name or description of the error.
+ @param exception NSException object that must be sent to the server.
+ @param onFailure Block to be executed if an error occurres while reporting, the error is passed as block argument.
+ */
+- (void)reportError:(NSString *)name
+          exception:(nullable NSException *)exception
+          onFailure:(nullable void (^)(NSError *error))onFailure;
+
+/** Resumes last session or creates a new one if it has been expired.
+ Should be used when auto tracking of application state is unavailable or is different.
+ */
+- (void)resumeSession;
+
+/** Pause current session.
+ All events reported after calling this method and till the session timeout will still join this session.
+ Should be used when auto tracking of application state is unavailable or is different.
+ */
+- (void)pauseSession;
+
+@end
+
+NS_ASSUME_NONNULL_END

example/ios/YandexMobileMetrica.framework/Versions/Current/Headers/YandexMobileMetrica.h

@@ -0,0 +1,24 @@
+/*
+ *  YandexMobileMetrica.h
+ *
+ * This file is a part of the AppMetrica
+ *
+ * Version for iOS © 2017 YANDEX
+ *
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.com/metrica_termsofuse/
+ */
+
+#if __has_include("YMMYandexMetrica.h")
+    #import "YMMYandexMetrica.h"
+    #import "YMMVersion.h"
+    #import "YMMYandexMetricaConfiguration.h"
+    #import "YMMYandexMetricaReporting.h"
+    #import "YMMYandexMetricaPreloadInfo.h"
+#else
+    #import <YandexMobileMetrica/YMMYandexMetrica.h>
+    #import <YandexMobileMetrica/YMMVersion.h>
+    #import <YandexMobileMetrica/YMMYandexMetricaConfiguration.h>
+    #import <YandexMobileMetrica/YMMYandexMetricaReporting.h>
+    #import <YandexMobileMetrica/YMMYandexMetricaPreloadInfo.h>
+#endif