Migrating to version 5.0.0

If dependencies are set via XcodeIf dependencies are set via Xcode

1. Delete the metrika-sdk-ios dependency.

   

2. In the Xcode Project Navigator window, select your project (if Workspace is used). In the top menu, click File and select Add Package Dependencies....

   

3. Specify the repository URL https://github.com/appmetrica/appmetrica-sdk-ios.

   

4. Leave only the required modules (to disable a module, select None in Add to Target):

   

   • AppMetricaCore: The mandatory main SDK module. It must be connected for working with AppMetrica.
   • AppMetricaAdSupport: The module is used to collect IDs, including IDFA.
   • AppMetricaCrashes: The module is intended for detecting crashes and sending errors.
   • AppMetricaWebKit: The module enables you to send events from JavaScript code in WebView.

When using the Package.swift manifestWhen using the Package.swift manifest

1. Delete the .package dependency with YandexMobileMetrica from the file Package.swift in your project together with all references to the dependencies in the targets: section within your project.

2. Insert the following code to add the new appmetrica-sdk-ios dependency:

   dependencies: [
     .package(
       name: "AppMetrica",
       url: "https://github.com/appmetrica/appmetrica-sdk-ios",
       .upToNextMinor(from: "5.0.0")
     ),
   ],
   

3. Add the required modules to your project's targets.

   • AppMetricaCore: The mandatory main SDK module. It must be connected for working with AppMetrica.
   • AppMetricaAdSupport: The module is used to collect IDs, including IDFA.
   • AppMetricaCrashes: The module is intended for detecting crashes and sending errors.
   • AppMetricaWebKit: The module enables you to send events from JavaScript code in WebView.

   .target(
       name: "MyTargetName",
       dependencies: [
         .product(name: "AppMetricaCore", package: "AppMetrica"),
         .product(name: "AppMetricaCrashes", package: "AppMetrica"),
         .product(name: "AppMetricaWebKit", package: "AppMetrica"),
         // .product(name: "AppMetricaAdSupport", package: "AppMetrica"), // This module is disabled
       ]
   ),
   

If dependencies are set via XcodeIf dependencies are set via Xcode

Open the project in Xcode. Make sure that Package Dependencies don't contain YandexMobileMetrica.

When using the Package.swift manifestWhen using the Package.swift manifest

If your project uses the Package.swift manifest to manage dependencies, execute the swift package show-dependencies command in the terminal in your project's directory. This will output a list of all project dependencies, including transitive ones.

.
└── yandex-ads-sdk-ios<https://github.com/yandexmobile/yandex-ads-sdk-ios.git@6.4.0>
  ├── metrica-sdk-ios<https://github.com/yandexmobile/metrica-sdk-ios@4.5.2>
  └── divkit-ios<https://github.com/divkit/divkit-ios@28.13.0>
      └── vgsl<https://github.com/yandex/vgsl.git@2.4.1>

You can also check Package.resolved for the YandexMobileMetrica dependency.

{
  "object": {
    "pins": [
      //...
      {
        "package": "YandexMobileMetrica",
        "repositoryURL": "https://github.com/yandexmobile/metrica-sdk-ios",
        "state": {
          "branch": null,
          "revision": "13d8b11181a33938ef42759d49466a621df5e7db",
          "version": "4.5.2"
        }
      },
      //...
    ]
  },
  // ...
}

#import <YandexMobileMetrica/YandexMobileMetrica.h>

Replace with:

#import <AppMetricaCore/AppMetricaCore.h>
#import <AppMetricaCrashes/AppMetricaCrashes.h> // if you need to work with errors/crashes
#import <AppMetricaWebKit/AppMetricaWebKit.h> // if you need to set up event sending from WebView

Changed the YMM prefix to AMA.

• Renamed the YMMYandexMetrica interface as AMAAppMetrica.
  • Renamed the +handleOpenURL: method as +trackOpeningURL:.
  • Renamed the +initWebViewReporting:onFailure: method as +setupWebViewReporting:onFailure:. For more information, see Sending an event from the WebView's JavaScript code.
  • Removed the +libraryVersion: method, use the libraryVersion property.
  • Removed the +reportError:exception:onFailure: method, see Working with crashes and errors
  • Moved the +reportError:onFailure: method to the AppMetricaCrashes class and the AppMetricaCrashes module, see Working with crashes and errors.
  • Moved the +reportError:options:onFailure: method to the AppMetricaCrashes class and the AppMetricaCrashes module, see Working with crashes and errors.
  • Renamed the +reportEvent:params:onFailure: method as +reportEvent:parameters:onFailure:
  • Moved the +reportNSError:onFailure: method to the AppMetricaCrashes class and the AppMetricaCrashes module, see Working with crashes and errors.
  • Moved the +reportNSError:options:onFailure: method to the AppMetricaCrashes class and the AppMetricaCrashes module, see Working with crashes and errors.
  • Removed the +reportReferralUrl: method.
  • Renamed the +reporterForApiKey: method as +reporterForAPIKey:.
  • Removed the +requestAppMetricaDeviceIDWithCompletionQueue: method, use +requestStartupIdentifiersWithKeys:completionQueue:completionBlock:.
  • Removed the +setErrorEnvironmentValue:forKey: method, use [[AMAAppMetricaCrashes crashes] setErrorEnvironmentValue:value forKey:key].
  • Removed the +setLocation: method, use the customLocation property.
  • Removed the +setLocationTracking: method, use the locationTrackingEnabled property.
  • Renamed the +setStatisticsSending: method as +setDataSendingEnabled:.
  • Removed the +setUserProfileID: method, use the userProfileID property.
• Renamed the YMMYandexMetricaConfiguration interface as AMAAppMetricaConfiguration.
  • Renamed the -initWithApiKey: constructor as -initWithAPIKey:.
  • Renamed the apiKey property as APIKey.
  • Removed the appForKids property, see Using the SDK for children's apps.
  • Removed the crashReporting property, see Working with crashes and errors.
  • Renamed the location property as customLocation.
  • Renamed the logs property as logsEnabled.
  • Renamed the statisticsSending property as dataSendingEnabled.
• Renamed the YMMYandexMetricaPreloadInfo interface as AMAAppMetricaPreloadInfo.

Reporter

• Renamed the YMMMutableReporterConfiguration interface as AMAMutableReporterConfiguration.
  • Renamed the logs property as logsEnabled.
  • Renamed the statisticsSending property as dataSendingEnabled.
• Renamed the YMMReporterConfiguration interface as AMAReporterConfiguration.
  • Renamed the -initWithApiKey: constructor as -initWithAPIKey:.
  • Renamed the apiKey property as APIKey.
  • Renamed the logs property as logsEnabled.
  • Renamed the statisticsSending property as dataSendingEnabled.
• Renamed the YMMYandexMetricaReporting protocol as AMAAppMetricaReporting.
  • Moved the +reportError:onFailure: method to the AppMetricaCrashes class and the AppMetricaCrashes module, see Working with crashes and errors.
  • Moved the +reportError:options:onFailure: method to the AppMetricaCrashes class and the AppMetricaCrashes module, see Working with crashes and errors.
  • Renamed the +reportEvent:params:onFailure: method as +reportEvent:parameters:onFailure:.
  • Moved the +reportNSError:onFailure: method to the AppMetricaCrashes class and the AppMetricaCrashes module, see Working with crashes and errors.
  • Moved the +reportNSError:options:onFailure: method to the AppMetricaCrashes class and the AppMetricaCrashes module, see Working with crashes and errors.
  • Renamed the +setStatisticsSending: method as +setDataSendingEnabled:.

User attributes

• Renamed the YMMMutableUserProfile interface as AMAMutableUserProfile.
• Renamed the YMMProfileAttribute interface as AMAProfileAttribute.
• Renamed the YMMUserProfile interface as AMAUserProfile.
• Renamed the YMMGenderType enumeration as AMAGenderType.
• Renamed the YMMBirthDateAttribute protocol as AMABirthDateAttribute.
• Renamed the YMMCustomBoolAttribute protocol as AMACustomBoolAttribute.
• Renamed the YMMCustomCounterAttribute protocol as AMACustomCounterAttribute.
• Renamed the YMMCustomNumberAttribute protocol as AMACustomNumberAttribute.
• Renamed the YMMCustomStringAttribute protocol as AMACustomStringAttribute.
• Renamed the YMMGenderAttribute protocol as AMAGenderAttribute.
• Renamed the YMMNameAttribute protocol as AMANameAttribute.
• Renamed the YMMNotificationsEnabledAttribute protocol as AMANotificationsEnabledAttribute.

Errors

• Renamed the YMMError interface as AMAError.
• Renamed the YMMBacktraceErrorKey constant as AMABacktraceErrorKey.
• Renamed the YMMErrorReportingOptions enumeration as AMAErrorReportingOptions.
• Renamed the YMMErrorRepresentable protocol as AMAErrorRepresentable.

AdRevenue

• Renamed the YMMAdRevenueInfo interface as AMAAdRevenueInfo.
• Renamed the YMMMutableAdRevenueInfo interface as AMAMutableAdRevenueInfo.
• Renamed the YMMAdType enumeration as AMAAdType.

ECommerce

• Renamed the YMMECommerceAmount interface as AMAECommerceAmount.
• Renamed the YMMECommerceCartItem interface as AMAECommerceCartItem.
• Renamed the YMMECommerceOrder interface as AMAECommerceOrder.
• Renamed the YMMECommercePrice interface as AMAECommercePrice.
• Renamed the YMMECommerceProduct interface as AMAECommerceProduct.
• Renamed the YMMECommerceReferrer interface as AMAECommerceReferrer.
• Renamed the YMMECommerceScreen interface as AMAECommerceScreen.
• Renamed the YMMECommerce interface as AMAECommerce.

Revenue

• Renamed the YMMMutableRevenueInfo interface as AMAMutableRevenueInfo.
• Renamed the YMMRevenueInfo interface as AMARevenueInfo.
  • Removed the -initWithPrice:currency: constructor, use -initWithPriceDecimal:currency:.
  • Removed the -initWithPrice:currency:quantity:productID:transactionID:receiptData:payload: constructor, use -initWithPriceDecimal:currency:quantity:productID:transactionID:receiptData:payload:.

Add the import to all files where you use crash or error API resources:

#import <AppMetricaCrashes/AppMetricaCrashes.h>

The crash sending logic is defined with the AMAAppMetricaCrashesConfiguration class:

AMAAppMetricaCrashesConfiguration *configuration = [[AMAAppMetricaCrashesConfiguration alloc] init];
configuration.autoCrashTracking = YES; // If this parameter is enabled, crashes are automatically sent to AppMetrca
configuration.probablyUnhandledCrashReporting = YES; // Use this parameter to enable or disable tracking of implicit failures, such as OOM crashes
configuration.ignoredCrashSignals = @[]; // This setting enables you to specify an array of UNIX signals from sys/signal.h that will be ignored by the failure tracking system
configuration.applicationNotRespondingDetection = YES; // This setting includes detecting situations when the main app thread stops responding (ANR)
configuration.applicationNotRespondingWatchdogInterval = 4.0; // Sets the time interval that the watchdog will wait before reporting the "Application Not Responding" status (ANR)
configuration.applicationNotRespondingPingInterval = 0.1; // Sets the frequency at which watchdog will check the "Application Not Responding" status (ANR)
[[AMAAppMetricaCrashes crashes] setConfiguration:configuration];

To send errors, use methods of the AppMetricaCrashes class. Their signature matches that of similar methods from YMMYandexMetrica, so all you need to do is replace YMMYandexMetrica with [AMAAppMetricaCrashes crashes].

[[AMAAppMetricaCrashes crashes] reportError:error onFailure:nil];
[[AMAAppMetricaCrashes crashes] reportError:error options:options onFailure:nil];
[[AMAAppMetricaCrashes crashes] reportNSError:error onFailure:nil];
[[AMAAppMetricaCrashes crashes] reportNSError:error options:options onFailure:nil];

Add the following string in each file where the WebView setting is used:

#import <AppMetricaWebKit/AppMetricaWebKit.h>

You need to replace the WKUserContentController instance with the instance of the AMAJSController wrapping. Replace:

WKUserContentController *userController = [[WKUserContentController alloc] init];
[YMMYandexMetrica initWebViewReporting:userController onFailure:nil];

with

WKUserContentController *userController = [[WKUserContentController alloc] init];
[AMAAppMetrica setupWebViewReporting:[[AMAJSController alloc] initWithUserContentController:userController] onFailure:nil];

If dependencies are set via XcodeIf dependencies are set via Xcode

Exclude AppMetricaAdSupport from Frameworks, Libraries, and Embedded Content for your target.

When using the Package.swift manifestWhen using the Package.swift manifest

Disable the AppMetricaAdSupport module:

 .target(
    name: "MyTargetName",
    dependencies: [
       .product(name: "AppMetricaCore", package: "AppMetrica"),
       .product(name: "AppMetricaCrashes", package: "AppMetrica"),
       .product(name: "AppMetricaWebKit", package: "AppMetrica"),
       // .product(name: "AppMetricaAdSupport", package: "AppMetrica"), // This module is disabled
    ]
 ),