5.0.0: π Open Source & Modular π
In the latest release of the AppMetrica SDK version 5.0.0, we're bringing a wealth of improvements and changes, all designed to streamline the migration process and enhance the capabilities of your app analytics.
What's Included in This Release
- Open Source Initiative: The entire SDK is now open-source, offering unprecedented access to its inner workings and fostering a community-driven development approach.
- Modular Design: Reflecting our commitment to flexibility, the SDK has been rearchitected into distinct modules. This allows for a more tailored integration, enabling you to incorporate only the components you need.
- New Modules Introduction: Beyond the foundational
AppMetricaCore
andAppMetricaCrashes
, we're introducingAppMetricaAdSupport
andAppMetricaWebKit
. These modules expand your toolkit, providing advanced features for ad support and web content interaction without adding unnecessary bulk to your app. - Smooth Transition Path: Ensuring a seamless migration from
YandexMobileMetrica
toAppMetrica
, we've carefully preserved all essential identifiers and data. This meticulous approach guarantees the integrity of your reporting data throughout the upgrade process.
Highlights for Developers
- Renamed Dependencies: For CocoaPods, replace
YandexMobileMetrica
withAppMetricaAnalytics
. Swift Package Manager users should transition from YandexMobileMetrica to the new AppMetrica repository. These changes simplify the integration process across different package managers and development environments. - Updated API for Clarity and Ease of Use: Significant renaming within the API streamlines interaction with the SDK. For instance,
YMMYandexMetrica
becomesAppMetrica
, accompanied by method name updates to enhance clarity and usability. - Advanced Error and Crash Reporting: The introduction of
AppMetricaCrashes
centralizes and enhances error reporting capabilities, providing detailed insights into application stability. - WebView Integration Simplified: Event reporting from WebView content has been refined, now requiring
AppMetricaWebKit
and the utilization ofJSController
for improved interaction. - Apps for Kids Compliance: The modular structure facilitates the exclusion of
AppMetricaAdSupport
when targeting younger audiences, ensuring compliance with child protection regulations.
Migration Guide Overview
This update requires attention to several key areas during migration:
- Verify the absence of concurrent SDK versions to maintain data accuracy.
- Update your project's dependencies according to the new guidelines for CocoaPods, SPM, or manual setups.
- Refactor your codebase to align with the updated API names and structures, including adjusting import statements and method calls.
- Utilize the
AppMetricaCrashes
module for all crash and error reporting needs, taking advantage of its enhanced capabilities. - For seamless event reporting within WebView, integrate
AppMetricaWebKit
to leverage theJSController
, facilitating effective data collection from web content.
We urge all developers to consult the comprehensive migration guide provided in the SDK documentation for a detailed walkthrough of these steps. This release paves the way for more robust and flexible app analytics, enabling developers to leverage a wider array of tools for monitoring and optimizing app performance.
Should you need further assistance or wish to share feedback, our support team is readily available to help.