---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://boost.yandex.com/doc/en/analytics/content/sdk/react-native/changelog.md
  - https://boost.yandex.com/doc/ru/analytics/content/sdk/react-native/changelog.md
  - https://boost.yandex.com/doc/zh/analytics/content/sdk/react-native/changelog.md
  - href: https://boost.yandex.com/doc/zh/analytics/content/sdk/react-native/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

# 更新日志

## Version 4.2.0 {#v-4-2-0}

Released July 31, 2026

- 已将 AppMetrica Android SDK 版本更新至 [8.4.1](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/changelog-android.md#s-8-4-1)。
- Added [从 RuStore 获取安装来源](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/technology.md#install-referrer).
- iOS SDK 依赖版本已更改为范围 `>= 5.16.0`, `< 7.0`.
- 向 `AppMetrica` 类中添加了 `setAdvIdentifiersTracking` 方法。

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

发布于2026年6月28日

- 添加了支持激活配置字段：`appBuildNumber`，`revenueAutoTrackingEnabled`，`deviceType`，`trackAdvIdentifiersEnabled`.
- iOS SDK 依赖版本已从固定更改为范围 `>= 5.16.0`, `< 6.0`.

## Version 3.6.0 {#v-3-6-0}

2026年2月6日发布

- 已将 AppMetrica AppMetrica Android SDK 版本更新至 [7.14.1](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/changelog-android.md#s-7-14-1).
  - 修复在数据发送被禁用时数据库达到限制时自动清除事件的问题。
  - 在 `analytics-id-sync` 模块中添加了实时数据发送功能。
  - 从 IronSource v9 自动收集广告收入数据
  - 添加了[额外的用户资料属性，可让您发送第一方数据](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-attribute-profile-1pd)。
  - 添加了新模块`analytics-id-sync`，它为与多个用户标识提供商进行工作提供了基础设施。
  - 添加了新模块`analytics-billing`，它整合了应用内购买收集功能。
  - 修复了几个崩溃和ANR问题。
- 已将 AppMetrica AppMetrica iOS SDK 版本更新至 [5.16.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/changelog-ios.md#v-5-16-0)。
  - 添加了通过用户属性发送第一方数据的支持。
  - 添加了与匿名标识提供商同步结果的实时传递功能。
  - Added `AppMetricaIDSync`，它提供了与多个用户标识提供商进行工作的基础设施。
  - 提升了ANR检测性能。
  - 使用 `journal_mode=wal` 来减少数据库的 I/O。
  - 已修复 `CLLocationManager` 中的死锁。
  - 修复了一个问题，即崩溃可能被错误地分配到会话中。
  - 已向 `AMAAppMetricaConfiguration` 和 `AMAAppMetrica` 添加 `advertisingIdentifierTrackingEnabled` 标志，以禁用 IDFA 发送。
  - 修复了当无法访问App Group时发生的崩溃问题。

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

2026年1月21日发布

- 添加了对新 React Native 架构的支持。
- Added `启动参数`类，包含常量用于`启动标识符`.
- 从 API 中移除承诺。
- 已将 AppMetrica AppMetrica Android SDK 版本更新至 [8.0.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/changelog-android.md#s-8-0-0)。
  - 修复了几个崩溃和ANR问题。
  - 修复在达到限制且 [data sending is disabled](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#stat) 时自动清除数据库中的事件。
- 已将 AppMetrica AppMetrica iOS SDK 版本更新至 [5.16.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/changelog-ios.md#v-5-16-0)。
  - 修复了几个崩溃和ANR问题。
  - 使用 `journal_mode=wal` 来减少数据库的 I/O。

## Version 3.5.0 {#v-3-5-0}

Released September 10, 2025

- 已将 `@types/jsdom` 添加到 `devDependencies`。
- 添加了对 `APP_OPEN` 的支持，位于 `AdType` 中。
- 当数据发送被禁止时，已添加禁止库发送任何网络请求的限制。 之前可以发送网络配置请求。
- 已将 AppMetrica Android SDK 版本更新至 [7.11.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/changelog-android.md#s-7-11-0)。
  - 添加了对 Google Play Billing Library v8 的完整支持。
  - Fixed possible crash `java.lang.NoSuchMethodError: 没有虚拟方法 enablePendingPurchases` 在使用 Google Play Billing v8 库时。
  - Fixed probable crash `java.lang.NullPointerException: 尝试在空对象引用上调用虚拟方法 void io.appmetrica.analytics.impl.x5.d() 在 io.appmetrica.analytics.impl.xe.a`.
  - 依赖降级：Google Play Services Ads Identifiers 从 `com.google.android.gms:play-services-ads-identifier:18.1.0`，以防止在 Android 6 及以下版本设备上可能出现的崩溃 `java.lang.NoClassDefFoundError: com.google.android.gms.ads.identifier.zzd`（在 18.2.0 版本）。
  - AppMetrica SDK 的主要组件已移至主应用程序进程。 SDK AppMetrica 现在已在主应用程序进程中完全运行。 完全避免单独的进程可以消除与其他库（例如 Firebase Performance）集成可能出现的问题。
- 已将AppMetrica iOS SDK 版本更新至 [5.12.1](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/changelog-ios.md#v-5-12-1).
  - 修复了在应用更新过程中发生崩溃时发送错误应用版本的问题。
  - 修复了由于文件锁（flock）处于活动状态而导致的崩溃（当应用进入暂停状态时）。
  - 已将 `KSCrash` 更新至 2.1.1.
  - 修复了一个迁移问题，该问题可能会覆盖标识符。

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

发布于2025年6月23日

 - 引入了一个新的错误报告API
 - 添加了对 AppEnvironment 的支持
 - 添加了对报告员的支持
 - 添加了对标识符的支持
 - 添加了对延迟深链的支持（仅限 Android）
 - 已修复 sourceCompatibility 版本错误 [GitHub Issue #8](https://github.com/appmetrica/appmetrica-react-native-plugin/issues/8)
 - 已将 AppMetrica Android SDK 版本更新至 [7.8.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/changelog-android.md#s-7-8-0)
   - AppMetrica SDK 的主要组件已移至主应用程序进程。 SDK AppMetrica 现在已在主应用程序进程中完全运行。 完全避免单独的进程可以消除与其他库（例如 Firebase Performance）集成可能出现的问题。
   - 已修复可能的 ANR
   - 修复了在同时使用 AppMetrica 插件（Unity、Flutter、ReactNative）和 Yandex Ads 插件时可能出现的统计问题（安装和新用户）。
   - 我们已优化了来源处理机制，从而修复了通过跟踪链接在最新版 Chromium 引擎浏览器（如 Google Chrome、Yandex 浏览器等）安装应用时收到延迟深链及其参数的错误。
 - 已将AppMetrica iOS SDK 版本更新至 [5.10.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/changelog-ios.md#v-5-10-0)。
   - 解决了 `AppMetricaProtobuf` 与使用 protobuf-c 的其他库之间的冲突。
   - 已将 iOS 的部署目标版本提升至 13.0。
   - 更新 KSCrash 依赖到版本 2.0.0。

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

2024年10月4日发布

- 现在可以将其他 SDK 的归因数据[导入 AppMetrica](https://boost.yandex.com/doc/zh/analytics/content/data-collection/attribution-integration-react.md)。

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

2024年9月25日发布

- 将 AppMetrica Android SDK 版本更新至 [7.2.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/changelog-android.md#s-7-2-0)。
  - 添加强制将某些类型的事件发送到服务器（来自外部 SDK 的归因、电子商务、收入、广告收入（Impression Level Revenue Data））。
- 将 AppMetrica iOS SDK 版本更新至 [5.8.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/changelog-ios.md#v-5-8-0)。
  - 移除 iAd 支持和对该库的引用。
  - 添加了事件参数日志记录。
  - 已将 KSCrash 更新至版本 `2.0.0-rc.1`。
  - 从 `NSPrivacyTrackingDomains` 中移除域，以符合 Apple 的隐私指南要求，这是 `AppMetricaCore` 依赖项的隐私清单中的修改，详见 [GitHub Issue #4](https://github.com/appmetrica/appmetrica-react-native-plugin/issues/4)。
  - 添加强制将某些类型的事件发送到服务器（来自外部 SDK 的归因、电子商务、收入、广告收入（Impression Level Revenue Data）、Apple 隐私设置）。

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

2024年7月11日发布

- AppMetrica Android SDK 已更新至版本 [7.0.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/changelog-android.md#s-7-0-0)。
   - 当前的 `minSdkVersion` 已升级至 `21`（Android 5.0）。
   - 已将`sourceCompatibility`和`targetCompatibility`版本升级到 Java 1.8。
   - 添加了单次请求向服务器发送事件的限制，最多100个事件。 该限制是为了在网络通道不稳定时提升 SDK 的性能。
   - 在客户端优化线程并移除已弃用的SDK集成检查。 优化是为了减少同步 SDK 激活的时间。
- AppMetrica iOS SDK 已更新至版本 [5.6.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/changelog-ios.md#v-5-6-0)。
   - 扩展程序现在默认使用后台会话。
- 添加了对发送[用户资料](https://boost.yandex.com/doc/zh/analytics/content/sdk/react-native/analytics/react-native-operations.md#send-attribute-profile)API的支持。
- Fixed `payload` 发送到 `ECommerce` 和 `AdRevenue` 事件，当它被设置为 `Map<string, string>`.
- 已添加对 `Record<string, string>` 类型的支持，以用于 `payload` 在 `ECommerce` 和 `AdRevenue` 事件中。

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

2024年6月10日发布

- 全局插件更新。 要了解更多信息，请查看[迁移说明](https://boost.yandex.com/doc/zh/analytics/content/sdk/react-native/analytics/migration-io-3-0-0.md)。
- 添加了关于将 [SDK 的 AppMetrica 集成](https://boost.yandex.com/doc/zh/analytics/content/sdk/react-native/analytics/quick-start.md#integration) 到 React Native Expo 应用程序中的描述。
- 已更新 AppMetrica SDK 版本（[Android 6.5.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/changelog-android.md#s-6-5-0)，[iOS 5.4.0](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/changelog-ios.md#v-5-4-0)）。
   - 为 iOS 添加了对 Privacy Manifest 的支持。
- 添加了用于发送电商事件的API。
- 添加了用于发送收入事件的API。
- 添加了用于发送 AdRevenue 事件的 API。
- 修复了一个有时会阻止 Android 会话启动跟踪的 bug。
- 添加了深链的自动跟踪。

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

2020年6月8日发布

- 与 AppMetrica SDK 集成（支持 iOS 和 Android 平台）
