---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://boost.yandex.com/doc/en/analytics/content/sdk/flutter/changelog.md
  - https://boost.yandex.com/doc/ru/analytics/content/sdk/flutter/changelog.md
  - https://boost.yandex.com/doc/zh/analytics/content/sdk/flutter/changelog.md
  - href: https://boost.yandex.com/doc/zh/analytics/content/sdk/flutter/changelog.md
    type: text/markdown
    title: Markdown version
  - href: https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064

# 更新日志

## AppMetrica SDK {#sdk}

### Version 4.1.0 {#v-4-1-0}

Release 2026年8月10日

- 修复 iOS UIScene 与其他插件的冲突：`scene:willConnectToSession:options:` 不再返回 `YES`，因此 `connectionOptions` 不会被消耗，仍可供后续插件使用。
- 已更新 AppMetrica SDK：Android 至 8.5.0，iOS 至 6.6。

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

Release 2026年3月25日

- 为 iOS 添加了 UIScene 生命周期支持。 初始深链检测现在在使用 UIScene 的应用中正确工作。
- 已更新 Flutter 最低版本至 3.38.0（Dart SDK 3.10.0）。
- 已修复在调用 `requestDeferredDeeplink` 时的崩溃。
- Removed `AppMetrica.reportReferralUrl` 方法。
- 改进了 iOS 本地 SDK 版本规范：现在定义了从最低版本到下一个主要版本的范围。
- 已添加 `AppMetricaConfig.advIdentifiersTracking` 对 iOS 的支持.
- Added `AppMetrica.activateInBackground` 方法用于在不启动前台会话的情况下激活后台。
- 已更新 AppMetrica SDK：Android 至 8.0.0，iOS 至 6.1。

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

2025年11月13日发布

- 已更新 AppMetrica SDK：Android 至 7.13.0，iOS 至 5.14
- 已将AGP版本更新至`8.2.0`。

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

2025年8月19日发布

- 修复编译错误 `没有已知的类方法用于选择器 'setAdProviderEnabled:'`

- 已更新 AppMetrica SDK：iOS 至 5.12。

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

2025年7月21日发布

- Fixed `appmetrica_plugin/AMAFAppMetricaActivator.h` 文件未找到错误。

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

2025年5月14日发布

- 已更新 AppMetrica SDK：Android 至 7.8.0，iOS 至 5.10。

- 提升与使用 Yandex.Ads SDK 时的统计数据。 在AndroidManifest中添加包含插件描述的元数据。

- 支持 Swift Package Manager 功能。

- 添加`appOpen`广告类型用于`adRevenue`事件。

- Add `AppMetrica.setAdvIdentifiersTracking` 方法以启用或禁用在报告中包含广告标识符。

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

2024年9月20日发布

- 已更新 AppMetrica SDK：Android 至 7.2.0，iOS 至 5.8。

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

2024年8月29日发布

- 为所有插件类添加了前缀 `AppMetrica`，以避免与外来代码冲突（详情请参见 [迁移指南](https://boost.yandex.com/doc/zh/analytics/content/sdk/flutter/analytics/migration-io-3-0-0.md)）。
- 添加了 `AppMetricaConfig.flutterCrashReporting` 参数，以禁用 Flutter 崩溃数据的收集。
- 将`十进制`依赖版本更新为`3.0.0`，并相应提高了最低 Flutter 版本。

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

2024年5月22日发布

- 修复了 `null` 处理中的错误 `AppMetrica.reportEventWithMap` 方法。

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

2024年5月7日发布

- 添加了发送外部归因的方法。
- 已在 `requestStartupParams` 方法中添加了要使用的键。

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

2024年3月26日发布

- SDK AppMetrica 已更新：Android 版本升至 6.3.0，iOS 版本升至 5.0。

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

2023年6月14日发布

- 插件的原生 Android 部分因 Kotlin 版本问题被重写为 Java。

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

2023年6月5日发布

- 添加了对深链的自动支持。
- 已更新 dev_dependencies。
- 修复和改进。

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

2022年10月10日发布

- 添加了对 AdRevenue API 的支持。
- 将 Android AppMetrica SDK 本地版本更新至 5.2.0，iOS 更新至 4.4。

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

2022年7月20日发布

- Fixed the NPE raised when creating `用户属性` with `null` arguments.

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

2022年7月14日发布

- 已将 Android AppMetrica SDK 本地版本更新至 5.0.0。

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

2022年2月22日发布

- Initial release. 支持 AppMetrica 中的大多数功能。 本地 SDK 版本：
   - Android: 4.2.0.
   - iOS: 4.2.

## Push SDK {#push}

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

Release August 11, 2026

- 修复 iOS UIScene 与其他插件（例如 `firebase_messaging`）的冲突：`scene:willConnectToSession:options:` 不再返回 `YES`，因此 `connectionOptions` 未被使用，仍可供后续插件使用。
- 已更新受支持的 `appmetrica_plugin` 版本至 4.1.0。

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

Release June 5, 2026

- 修复了使用 SPM 构建时出现的“无法解析包依赖”错误。

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

发布于 2026年4月16日 

- 为 iOS 添加了 UIScene 生命周期支持。 启动推送通知检测现在在使用 UIScene 的应用中正确工作（iOS 27+ 要求，Flutter 3.41+ 默认）。
- 已更新 Flutter 最低版本至 3.38.0（Dart SDK 3.10.0）。
- 已更新受支持的 `appmetrica_plugin` 版本至 4.0.0。
- `AppMetricaPushInfo`已添加到公开API。
- iOS 本地 SDK 版本规范已得到改进：现在它定义了从最低版本到下一个主要版本的范围。
- 本地 SDK 版本：
  - Android: 4.3.0
  - iOS: 3.4

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

Release 2025年10月24日

- 已添加方法 `AppMetricaPush.enableLogger`。
- 已更新 `min sdk环境` 版本至 `2.15.0`.
- 已将AGP版本更新至`8.2.0`。

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

Release August 13, 2025

- 点击通知时修复了有效负载处理。

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

Release July 22, 2025

- 已更新受支持的`appmetrica_plugin`版本至[3.2.1](#v-3-2-1)。
- Fixed `文件未找到`错误在构建过程中。

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

- 支持 Swift Package Manager 功能。
- 已更新支持的 `appmetrica_plugin` 版本至 [3.2.0](#v-3-2-0)。
- 支持与不同推送服务商（Firebase、RuStore、HMS）的工作。 请注意[使用特点](https://boost.yandex.com/doc/zh/analytics/content/sdk/flutter/push/usage-features.md)。
- 添加方法以从通知获取`payload`。
- 本地 SDK 版本：
   - Android: 4.1.1
   - iOS: 3.1 或更高版本

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

- 将 AppMetrica Flutter SDK 版本更新至 [3.0.0](#v-3-0-0)。

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

2024年5月6日发布

- 已更新的 Push SDK 版本（AppMetrica iOS 2.0.0[，](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/changelog-ios.md#v-push-2-0-0)[Android 3.2.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/changelog-android.md#v-3-2-0)）。

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

2023年6月16日发布

- 插件的原生 Android 部分因 Kotlin 版本问题而被重写为 Java。
- 已更新 dev_dependencies。

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

2022年8月29日发布

- 已更新的 AppMetrica Push SDK（[iOS 1.3.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/changelog-ios.md)，[Android 2.2.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/changelog-android.md)）。
- 将 appmetrica_plugin 版本更新至 [1.0.1](https://boost.yandex.com/doc/zh/analytics/content/sdk/flutter/changelog.md)。

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

2022年3月15日发布

Initial release. 支持 AppMetrica Push SDK 中的大多数功能。 本地 SDK 版本：
- Android: 2.1.1.
- iOS: 1.1.