---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://appmetrica.yandex.by/docs/en/sdk/flutter/changelog.md
  - https://appmetrica.yandex.by/docs/ru/sdk/flutter/changelog.md
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/en/llms.txt

# Changelog

## AppMetrica SDK {#sdk}

### Version 4.0.0 {#v-4-0-0}

Release March 25, 2026

- Added UIScene lifecycle support for iOS. Initial deeplink detection now works correctly in apps using UIScene.
- Updated minimum Flutter version to 3.38.0 (Dart SDK 3.10.0).
- Fixed crash on call `requestDeferredDeeplink`.
- Removed `AppMetrica.reportReferralUrl` method.
- Improved native SDK version specification for iOS: now defines a range from the minimum version up to the next major version.
- Added `AppMetricaConfig.advIdentifiersTracking` support for iOS.
- Added `AppMetrica.activateInBackground` method for background activation without starting a foreground session.
- Updated the AppMetrica SDK: Android to 8.0.0, iOS to 6.1.

### Version 3.4.0 {#v-3-4-0}

Released November 13, 2025

- Updated the AppMetrica SDK: Android to 7.13.0, iOS to 5.14.
- Updated AGP version to `8.2.0`.

### Version 3.3.0 {#v-3-3-0}

Released August 19, 2025

- Fixed compilation error `No known class method for selector 'setAdProviderEnabled:'`.

- Updated the AppMetrica SDK: iOS to 5.12.

### Version 3.2.1 {#v-3-2-1}

Released July 21, 2025

- Fixed `appmetrica_plugin/AMAFAppMetricaActivator.h` file not found error.

### Version 3.2.0 {#v-3-2-0}

Released May 14, 2025

- Updated the AppMetrica SDK: Android to 7.8.0, iOS to 5.10.

- Improve statistics when using with Yandex.Ads SDK. Add meta-data with plugin description to AndroidManifest.

- Support Swift Package Manager feature.

- Add `appOpen` ad type for `adRevenue` events.

- Add `AppMetrica.setAdvIdentifiersTracking` method to enable/disable including advertising identifiers withing its reports.

### Version 3.1.0 {#v-3-1-0}

Released September 20, 2024

- Updated the AppMetrica SDK: Android to 7.2.0, iOS to 5.8.

### Version 3.0.0 {#v-3-0-0}

Released August 29, 2024

- Added the prefix `AppMetrica` to all plugin classes to avoid conflicts with foreign code (For more details, see the [migration guide](https://appmetrica.yandex.by/docs/en/sdk/flutter/analytics/migration-io-3-0-0.md)).
- Added the `AppMetricaConfig.flutterCrashReporting` parameter to disable the collection of flutter crashes.
- Updated the `decimal` dependency version to `3.0.0` and accordingly increased the minimum flutter version.

### Version 2.1.1 {#v-2-1-1}

Released May 22, 2024

- Fixed incorrect `null` processing in the `AppMetrica.reportEventWithMap` method.

### Version 2.1.0 {#v-2-1-0}

Released May 7, 2024

- Added methods for sending the external attribution.
- Added keys to be used in the `requestStartupParams` method.

### Version 2.0.0 {#v-2-0-0}

Released March 26, 2024

- The AppMetrica SDK has been updated for Android to version 6.3.0 and for iOS to version 5.0.

### Version 1.3.0 {#v-1-3-0}

Released June 14, 2023

- The native android part of the plugin was rewritten on java due to the problems with kotlin versions.

### Version 1.2.0 {#v-1-2-0}

Released June 5, 2023

- Added auto support for deeplinks.
- Updated dev_dependencies.
- Fixes and improvements.

### Version 1.1.0 {#v-1-1-0}

Released October 10, 2022

- Added support for the AdRevenue API.
- Updated the Android AppMetrica SDK native version to 5.2.0, iOS to 4.4.

### Version 1.0.1 {#v-1-0-1}

Released July 20, 2022

- Fixed the NPE raised when creating `UserProfileAttribute` with `null` arguments.

### Version 1.0.0 {#v-1-0-0}

Released July 14, 2022

- Updated the Android AppMetrica SDK native version to 5.0.0.

### Version 0.1.0 {#v-0-1-0}

Released February 22, 2022

- Initial release. Supports most of the features available in AppMetrica. Native SDK versions:
   - Android: 4.2.0.
   - iOS: 4.2.

## Push SDK {#push}

### Version 3.0.1 {#v-push-3-0-1}

Release June 5, 2026

- Fixed "Could not resolve package dependencies" error while building with SPM.

### Version 3.0.0 {#v-push-3-0-0}

Release April 16, 2026 

- Added UIScene lifecycle support for iOS. Launch push notification detection now works correctly in apps using UIScene (required by iOS 27+, default in Flutter 3.41+).
- Updated minimum Flutter version to 3.38.0 (Dart SDK 3.10.0).
- Updated supported `appmetrica_plugin` version to 4.0.0.
- `AppMetricaPushInfo` added to public API.
- The specification of the native SDK version for iOS has been improved: now it defines a range from the minimum version up to the next major version.
- Native SDK versions:
  - Android: 4.3.0
  - iOS: 3.4

### Version 2.4.0 {#v-push-2-4-0}

Release October 24, 2025

- Added method `AppMetricaPush.enableLogger`.
- Updated `min sdk environment` version to `2.15.0`.
- Updated AGP version to `8.2.0`.

### Version 2.3.0 {#v-push-2-3-0}

Release August 13, 2025

- Fixed payload handling when clicking on a notification.

### Version 2.2.0 {#v-push-2-2-0}

Release July 22, 2025

- Updated supported `appmetrica_plugin` version to [3.2.1](#v-3-2-1).
- Fixed `file not found` error during building.

### Version 2.1.0 {#v-push-2-1-0}

- Support Swift Package Manager feature.
- Updated supported `appmetrica_plugin` version to [3.2.0](#v-3-2-0).
- Support work with different push providers (Firebase, RuStore, HMS). Please pay attention to the [usage specifics](https://appmetrica.yandex.by/docs/en/sdk/flutter/push/usage-features.md).
- Add method do get `payload` from notification.
- Native SDK versions:
   - Android: 4.1.1
   - iOS: 3.1 or higher

### Version 2.0.0 {#v-push-2-0-0}

- Updated the AppMetrica Flutter SDK version to [3.0.0](#v-3-0-0).

### Version 1.0.0 {#v-push-1-0-0}

Released May 6, 2024

- Updated versions of the AppMetrica Push SDK ([iOS 2.0.0](https://appmetrica.yandex.by/docs/en/sdk/ios/changelog-ios.md#v-push-2-0-0), [Android 3.2.0](https://appmetrica.yandex.by/docs/en/sdk/android/changelog-android.md#v-3-2-0)).

### Version 0.3.0 {#v-push-0-3-0}

Released June 16, 2023

- The native android part of the plugin was rewritten on java due to the problems with kotlin versions.
- Updated dev_dependencies.

### Version 0.2.0 {#v-push-0-2-0}

Released August 29, 2022

- Updated versions of the AppMetrica Push SDK ([iOS 1.3.0](https://appmetrica.yandex.by/docs/en/sdk/ios/changelog-ios.md), [Android 2.2.0](https://appmetrica.yandex.by/docs/en/sdk/android/changelog-android.md)).
- Updated the appmetrica_plugin version to [1.0.1](https://appmetrica.yandex.by/docs/en/sdk/flutter/changelog.md).

### Version 0.1.0 {#v-push-0-1-0}

Released March 15, 2022

Initial release. Supports most of the features available in the AppMetrica Push SDK. Native SDK versions:
- Android: 2.1.1.
- iOS: 1.1.