--- metadata: - name: generator content: Diplodoc Platform v5.64.0 alternate: - https://boost.yandex.com/doc/en/analytics/content/sdk/android/changelog-android.md - https://boost.yandex.com/doc/ru/analytics/content/sdk/android/changelog-android.md - https://boost.yandex.com/doc/zh/analytics/content/sdk/android/changelog-android.md - href: https://boost.yandex.com/doc/zh/analytics/content/sdk/android/changelog-android.md type: text/markdown title: Markdown version - href: https://boost.yandex.com/doc/zh/llms.txt?revision=r21772739 rel: describedby --- > **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/zh/llms.txt?revision=r21772739 # 更新日志 ## AppMetrica SDK ### Version 8.5.0 {#s-8-5-0} Release 2026年7月29日 - 添加了在 `AppMetricaLibraryAdapter` 中配置自定义主机的功能。 - 添加了 `AppMetrica.clearErrorEnvironment`、`AppMetricaYandex.clearErrorEnvironment` 和 `IReporter.clearErrorEnvironment` 方法，用于清除错误环境。 - 为次级报告者通过 `IReporter.putErrorEnvironmentValue`、`ReporterConfig.Builder.withErrorEnvironmentValue` 和 `ReporterYandexConfig.Builder.withErrorEnvironmentValue` 添加了错误环境支持。 - Removed `服务截图捕获器`从截图检测中移除。 - 已将最低支持的 OkHttp 版本更新为 `4.12.0`. ### Version 8.4.1 {#s-8-4-1} Release 2026年7月18日 - 修复了空会话的数据发送问题。 ### Version 8.4.0 {#s-8-4-0} Release July 16, 2026 - 添加了新模块 `io.appmetrica.analytics:analytics-product-flow` 和 API，用于 [跟踪产品场景和推广事件](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-product-flow.md)。 要了解更多关于该方法的详情，请查看[在产品场景中提供事件](https://boost.yandex.com/doc/zh/analytics/content/data-collection/offers.md)。 - Fixed `ReporterConfig.Builder.withAppEnvironmentValue` 未应用到创建的次级报告器上。 - 修复了在调用 `registerReceiver` 时可能出现的崩溃。 - 将用于分割日志中长字符串的正则表达式的初始化延迟到第一次使用时。 ### Version 8.3.2 {#s-8-3-2} Release 2026年8月10日 - 修复了由于为每个网络请求创建新的`OkHttpClient`而导致的空闲OkHttp连接逐渐累积的问题：现在客户端会重用共享的`ConnectionPool`和`Dispatcher`. ### Version 8.3.1 {#s-8-3-1} Release 2026年7月18日 - 修复了空会话的数据发送问题。 ### Version 8.3.0 {#s-8-3-0} Release June 5, 2026 - Added [从 AppLovin MAX v12 自动收集广告收入数据](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-applovin-max). 要了解模块的更多详情，请查看[模块列表](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/android-modules.md)。 ### Version 8.2.0 {#s-8-2-0} Release May 14, 2026 - Added [从 RuStore 获取安装来源](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/technology.md#install-referrer). - 添加了新模块 `io.appmetrica.analytics:analytics-ad-revenue-other`，用于收集 [来自其他广告网络的广告收益数据](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-manual-integration)。 - Fixed [`profileId`](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-profile-id) 没有正确应用，当 AppMetrica SDK 与 Yandex Ads SDK 同时激活时。 ### Version 8.1.0 {#s-8-1-0} 发布日期：2026年4月13日 - Bumped `targetSdkVersion` 和 `compileSdkVersion` 到 `36`. - 已将 `org.jetbrains.kotlin:kotlin-stdlib` 更新至 `1.9.25`。 - JVM 目标版本已更新至 `1.8`. - 调整了 [安装来源](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/technology.md#install-referrer) 的发送逻辑：现在安装来源会从与应用安装程序匹配的源发送。 - 如果有 `deviceId` 值，`AppMetrica.getDeviceID()` 现在会在不进行激活的情况下返回该值。 Otherwise, `null` 被返回。 要了解获取 ID 的更多详情，请参阅[文档](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#get-ids)。 - 在某些边界情况下修复了可能的 UUID 不一致问题（跨多个主要版本升级 SDK）：API 返回的 UUID 与随事件发送的 UUID 不匹配。 - 在后台线程恢复了主服务回调处理，这应该能修复ANR：`at io.appmetrica.analytics.impl.p5.d, at io.appmetrica.analytics.impl.b4.a`, `at io.appmetrica.analytics.impl.tb.c`. - Fixed a possible **死锁** `main (被阻塞):tid=1 at io.appmetrica.analytics.impl.D4.a(SourceFile:18)`. - 修复了一个潜在问题，该问题可能导致由于数据库读取非原子性而事件以非时间顺序发送。 - 修复了一个问题，该问题会导致崩溃报告被记录在错误的应用版本下。 该问题影响了连续发生多次崩溃的情况。 - 更改了确定崩溃时间戳的方式。 之前，崩溃时间可以从最后一个发送事件的时间戳中推算出来。 - 数据库层更新了SQL查询：部分查询中的格式化字符串被参数化查询替代，以提升数据库效率并消除SQL注入检测器的假阳性结果。 - Fixed `StrictModeHelper$ViolationException: UnsafeIntentLaunchViolation: 启动不安全意图：Intent { act=io.appmetrica.analytics.IAppMetricaService...` 在连接到 Analytics module. - 已修复 `StrictModeHelper$ViolationException: DiskReadViolation 位于 io.appmetrica.analytics.impl.Ve.a(SourceFile:4)` 在 AppMetrica SDK 服务启动时。 - 事件和会话清理现在在单个数据库事务中执行。 - 优化磁盘写入：切换到缓冲写入可显著减少I/O操作次数和写入的数据量。 - 优化获取[广告标识符](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/get-ad-id.md)。 ### Version 8.0.1 {#s-8-0-1} Release April 5, 2026 - 已修复可能的死锁 `main（已阻塞）:tid=1 at io.appmetrica.analytics.impl.D4.a(SourceFile:18)`. - 在后台线程恢复主要服务回调处理以修复ANR：`at io.appmetrica.analytics.impl.p5.d`，`at io.appmetrica.analytics.impl.b4.a`，`at io.appmetrica.analytics.impl.tb.c`. ### Version 7.14.3 {#s-7-14-3} Release April 5, 2026 - 在后台线程恢复主要服务回调处理以修复ANR：`at io.appmetrica.analytics.impl.p5.d`，`at io.appmetrica.analytics.impl.b4.a`，`at io.appmetrica.analytics.impl.tb.c`. ### Version 7.14.2 {#s-7-14-2} Release 2026年3月3日 - Fixed `StrictModeHelper$ViolationException: UnsafeIntentLaunchViolation: 启动不安全意图：Intent { act=io.appmetrica.analytics.IAppMetricaService...` 在连接到 Boost. - 已修复 `StrictModeHelper$ViolationException: DiskReadViolation at io.appmetrica.analytics.impl.Ve.a(SourceFile:4)` 在 AppMetrica SDK 服务启动时。 ### Version 8.0.0 {#s-8-0-0} Release January 1, 2026 - 网络请求的实现已进行了重构。 默认情况下，它们是使用 OkHttp 创建的。 要使用网络请求的旧实现，请排除 `io.appmetrica.analytics:analytics-network-okhttp` 模块，并包含 `io.appmetrica.analytics:analytics-network-legacy` 模块。 - 已移除 `AppMetrica.reportReferralUrl` 方法。 - 已添加 `io.appmetrica.analytics:analytics-apphud-v3` 模块，用于与 AppHud SDK 版本 `3.0.0` 或更高版本进行工作。 要了解更多详情，请参见[Boost 和 Apphud](https://boost.yandex.com/doc/zh/analytics/content/data-collection/apphud/apphud-about.md)。 ### Version 7.14.1 {#s-7-14-1} Release December 28, 2025 - 修复在数据发送被禁用时数据库达到限制时自动清除事件的问题。 - 在 [`analytics-id-sync`](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/android-modules.md) 模块中添加了实时数据发送功能。 ### Version 7.14.0 {#s-7-14-0} Release November 26, 2025 - 添加了[额外的用户资料属性，可用于发送第一方数据：电话号码哈希、电子邮箱哈希和Telegram登录哈希](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-attribute-profile-1pd)。 - Added [从 IronSource v9 自动收集广告收入数据](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-automatic-integration-ironsource). - 添加了通过系统属性 `ro.yndx.metrica.db.dir` 重新定义保存主数据库文件路径的功能。 此功能可用于设备内存较少的供应商，以优化内存使用。 - SDK 的广播接收器将在后台线程中被调用。 - **固定** 可能的崩溃 `java.util.ConcurrentModificationException at io.appmetrica.analytics.impl.Hr.a(SourceFile:15)`. - **固定** 可能的 ANR ` 在 io.appmetrica.analytics.impl.vn.uncaughtException(源文件:19)`. - **固定** 可能的 ANR ` 在 io.appmetrica.analytics.internal.AppMetricaService.onCreate(AppMetricaService.java:44)`. ### Version 7.13.0 {#s-7-13-0} Release 2025年10月17日 - 已添加新模块 [`analytics-id-sync`](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/android-modules.md). 该模块提供了与多个用户标识提供商进行工作的基础架构，支持对匿名观众进行定位和标识合并，同时保障用户隐私。 该模块增强了集成能力，并提升了跨平台环境下系统的总体性能。 - 添加了新模块 [`analytics-billing`](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/android-modules.md)。 该模块聚合了[应用内购买收集](https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-revenue.md)功能，并允许您在必要时排除它。 - Fixed possible crash `java.lang.NullPointerException: 尝试在空对象引用上调用虚拟方法 'void io.appmetrica.analytics.impl.I5.e()' at io.appmetrica.analytics.impl.ef.onWaitFinished(:13)`. ### Version 7.12.0 {#s-7-12-0} Release 2025年9月4日 - Changed the ironsource artifact to `com.unity3d.ads-mediation:mediation-sdk` for [广告收入](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue) collecting. - 更新了[依赖版本列表](https://github.com/appmetrica/appmetrica-sdk-android/blob/main/dependencies_versions.yaml)，用于检查兼容性。 ### Version 7.11.0 {#s-7-11-0} Release 2025年8月21日 - 添加了对 Google Play Billing Library v8 的完整支持。 关于[发送收入](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-revenue)和[应用内购买](https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-revenue.md)的更多详情。 - 改进了 [设备类型](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#device-type) 的 TV 检测。 - Fixed probable crash `java.lang.NullPointerException: 尝试在空对象引用上调用虚拟方法 void io.appmetrica.analytics.impl.x5.d() at io.appmetrica.analytics.impl.xe.a`. ### Version 7.10.0 {#s-7-10-0} Release 2025年7月11日 - 当[数据发送被禁用](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#stat)时，添加了禁止库发送任何网络请求的限制。 之前可以发送网络配置请求。 - 修复了崩溃后会话可能未完成的问题。 - Fixed possible crash `java.lang.NoSuchMethodError: 没有虚拟方法 enablePendingPurchases` 当使用 Google Play Billing v8 库时。 目前，从 Google Play Billing v8 自动收集应用内购买数据不起作用。 未来版本将添加对 Google Play Billing v8 的完整支持。 - 依赖降级：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 版本）。 - 依赖更新：AppHud SDK 至 `com.apphud:ApphudSDK-Android:2.9.2` ### Version 7.9.0 {#s-7-9-0} Release 2025年5月8日 - AppMetrica SDK 的主要组件已移至主应用程序进程。 SDK AppMetrica 现在已在主应用程序进程中完全运行。 完全避免单独的进程可以消除与其他库（例如 Firebase Performance）集成可能出现的问题。 - 添加了对插件广告收入数据未来自动收集的支持。 - 修复了可能的ANR： - `at com.android.billingclient.api.BillingClientImpl.zzaJ(BillingClientImpl.java:1)` ([issue#19](https://github.com/appmetrica/appmetrica-sdk-android/issues/19)). - `at io.appmetrica.analytics.impl.Uf.onInstallReferrerSetupFinished(Uf.java:3)` ([issue#20](https://github.com/appmetrica/appmetrica-sdk-android/issues/20)). ### Version 7.8.0 {#s-7-8-0} Release April 9, 2025 - 已添加可选模块 `io.appmetrica.analytics:analytics-screenshot`。 它会检测用户是否截取了屏幕。 当检测到时，会发送客户端事件`appmetrica_system_event_screenshot`。 为了正确工作，需要在 AndroidManifest.xml 中添加权限 [android.permission.DETECT_SCREEN_CAPTURE](https://developer.android.com/reference/android/Manifest.permission#DETECT_SCREEN_CAPTURE)。 要了解模块的更多详情，请查看[模块列表](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/android-modules.md)。 - 修复了可能导致自动收集的应用内购买数据重复的问题。 - 修复了一个问题，该问题可能会导致非常旧的应用内购买用当前日期自动收集，从而可能扭曲报告。 - **依赖更新：** - Google Play 服务位置 到 `com.google.android.gms:play-services-location:21.0.1`; - Google Play 购买服务到 `com.android.billingclient:billing:7.1.1`; - Google Play 广告到 `com.google.android.gms:play-services-ads:24.1.0`; - AppLovin SDK 到 `com.applovin:applovin-sdk:13.1.0`; - FairBid SDK 到 `com.fyber:fairbid-sdk:3.59.0`; - AppHud SDK 到 `com.apphud:ApphudSDK-Android:2.9.1`; - Google Play Services AppSet ID 到 `com.google.android.gms:play-services-appset:16.1.0`; - Google Play 服务广告标识符到 `com.google.android.gms:play-services-ads-identifier:18.2.0` - 添加了管理对[广告标识符](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#track-adv-identifiers)的访问权限的能力到`AppMetricaLibraryAdapter`。 ### Version 7.7.0 {#s-7-7-0} Release 2025年2月14日 - 在广告收入模块中将Apphud SDK更新至2.8.4版本。 - 有关原始广告类型的信息已添加到[广告收入](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue)事件中。 - 为来自 [AdMob](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-google-admob) SDK 的广告收入事件添加了 `APP_OPEN` 类型。 - 已修复可能的 ANR: - `at io.appmetrica.analytics.impl.nm.onDestroy(nm.java:1)` ([issue#16](https://github.com/appmetrica/appmetrica-sdk-android/issues/16)). - `at io.appmetrica.analytics.networktasks.internal.NetworkCore.stopTasks(NetworkCore.java:1)` ([issue#17](https://github.com/appmetrica/appmetrica-sdk-android/issues/17)). ### Version 7.6.0 {#s-7-6-0} 2025年1月23日发布 - 修复了使用 AppMetrica 插件（Unity、Flutter、ReactNative）和 Yandex Ads 插件同时运行时可能出现的统计问题（安装和新用户）。 - 修复了在激活前访问 AppMetrica API 时可能出现的 ANR。 ### Version 7.5.0 {#s-7-5-0} 2024年12月5日发布 * 添加了用于管理访问广告标识符（GAID、Huawei OAID）的API。 查看[文档](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#track-adv-identifiers)。 ### Version 7.4.0 {#s-7-4-0} 2024年11月29日发布 * 已优化来源处理机制，从而修复了通过跟踪链接在最新版 Chromium 引擎浏览器（如 Google Chrome、Yandex 浏览器等）安装应用时收到 [延迟深链](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-deferred-deeplinks.md) 及其参数的错误。 ### Version 7.3.0 {#s-7-3-0} 2024年11月5日发布 * 添加了 `AppMetrica#reportAnr()` 和 `IReporter#reportAnr()` 方法，允许您手动发送 [ANR](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/anr.md) 数据。 * 修复了可能的 `java.lang.IllegalArgumentException:... at io.appmetrica.analytics.impl.K7.a(K7.java:27)` 崩溃。 * 修复了在应用构建过程中出现的 `缺失类 com.google.android.gms.ads.AdValue` 警告（[issue#10](https://github.com/appmetrica/appmetrica-sdk-android/issues/10)）。 ### Version 7.2.2 {#s-7-2-2} 2024年10月23日发布 * 添加了额外的检查，以验证 AppMetrica SDK 初始化已完成。 ### Version 7.2.1 {#s-7-2-1} 2024年10月3日发布 * 优化了通过第三方库适配器激活 AppMetrica SDK 时对非首次启动应用的检测。 * 如果您在第三方库适配器激活前发送事件，或者使用无效参数发送事件，现在这些事件将被忽略，而不是抛出异常。 ### Version 7.2.0 {#s-7-2-0} 2024年9月11日发布 * 取消了用于检测 AppMetrica SDK 和 AppMetrica Push SDK 内部崩溃的本地机制，改用后端解决方案。 * 已添加 `io.appmetrica.analytics:analytics-apphud` 模块以进行 Apphud 集成。 要了解更多详情，请参见[Boost和Apphud](https://boost.yandex.com/doc/zh/analytics/content/data-collection/apphud/apphud-about.md)。 * 添加了一个 API，以简化从 [Google AdMob](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-google-admob) 发送广告展示级收入数据（ILRD）的流程，针对“App open ad”广告格式。 * 事件日志功能改进。 ### Version 7.1.0 {#s-7-1-0} 2024年8月21日发布 - 添加了一个API，以便从以下位置发送ILRD（展现级收入数据）： - [Digital Turbine](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-digital-turbine) - [Google AdMob](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-google-admob) - [Applovin MAX](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-applovin-max) - 添加了对部分事件的加速发送支持（来自外部 SDK 的归因`、电子商务`、收入`以及广告收入`（广告展示级别的收入数据）``）到服务器。 ### Version 7.0.0 {#s-7-0-0} 发布于2024年6月28日 **重大变更：** * 当前的 `minSdkVersion` 已升级为 `21`（Android 5.0）。 * 源兼容性`（sourceCompatibility`）和目标兼容性`（targetCompatibility`）版本已升级到 Java 1.8。 **额外的更改：** * 为崩溃和错误报告添加了无效格式纠正。 此变更解决了潜在的崩溃问题 ```java translate=no java.lang.IllegalArgumentException: Unpaired surrogate at index 14 at io.appmetrica.analytics.protobuf.nano.CodedOutputByteBufferNano.encodedLengthGeneral(Unknown Source) ``` * 已修复可能的 ANR `在 io.appmetrica.analytics.impl.sk.a(sk.java:1)`. * 修复了可能的崩溃 ```java translate=no java.lang.NullPointerException: Attempt to invoke virtual method 'void io.appmetrica.analytics.impl.Nb.a(io.appmetrica.analytics.impl.ie)' on a null object reference at io.appmetrica.analytics.impl.Qb.b(SourceFile:10) ``` * 引入了每次服务器请求最多100个事件的限制。 该限制是为了在网络通道不稳定时提升 SDK 的性能。 * 在客户端优化线程，并移除已弃用的SDK集成检查。 此优化将减少同步 SDK 激活的时间。 ### Version 6.5.0 {#s-6-5-0} 2024年4月26日发布 * 添加了从 Singular 发送归因的功能（所需 API 可在 [Singular SDK 12.5.1 及更高版本](https://support.singular.net/hc/en-us/articles/360041068651-Android-SDK-Change-Log) 中使用）。 要了解更多信息，请查看[从其他 SDK 导入归因](https://boost.yandex.com/doc/zh/analytics/content/data-collection/attribution-integration.md)。 * 在API中移除了方法参数的名称混淆。 ### Version 6.4.0 {#s-6-4-0} 2024年4月11日发布 * 现在您可以从以下来源自动获取`广告展示级收入数据`：[Ironsource V7](https://developers.is.com/)（[文档](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-automatic-integration-ironsource)）和[Fyber V3](https://developer.digitalturbine.com/hc/en-us)（[文档](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-digital-turbine)）。 请参见[禁用广告收入数据的自动收集](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/off-adrevenue.md)和[使用Fyber时广告收入自动收集的冲突](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-errors.md#fyber-unsupport-adrevenue)。 * 已修复记录在系统日志中的错误： ``` E ActivityThread: 无法找到提供程序信息 com.yandex.preinstallsatellite.appmetrica.provider ``` ### Version 6.3.0 {#s-6-3-0} 2024年3月18日发布 * `UUID`格式验证和恢复无效`UUID`值现在可用。 * ANR 检测算法已改进。 现在，ANR 仅在单个 `Runnable` 在主线程分配的时间内无法执行时才被记录。 算法会识别导致主线程冻结的耗时任务。 之前，ANR 检测在主线程执行大量小型 `Runnables` 时被触发。 在这种情况下，ANR 堆栈跟踪通常不提供有用的信息，几乎无助于排查问题。 * 现在，如果单个 `Runnable` 冻结，就会生成一份 ANR 报告。 这减少了ANR报告的数量，但提高了它们的实用性。 * 修复了可能的 ANR ` 在 io.appmetrica.analytics.internal.AppMetricaService.onCreate` ([issue#3](https://github.com/appmetrica/appmetrica-sdk-android/issues/3))。 * 修复了发送外部归因时可能导致崩溃的问题 (`org.json.JSONException: Forbidden numeric value: NaN`，AppMetrica#reportExternalAttribution(...)``)。 ### Version 6.2.1 {#s-6-2-1} 2024年1月26日发布 * 修复了外部归因序列化的错误。 ### Version 6.2.0 {#s-6-2-0} 2024年1月22日发布 * 添加了 `AppMetrica.reportExternalAttribution` 方法，用于从外部库发送归因数据。 要了解更多，请查看[从其他 SDK 导入归因](https://boost.yandex.com/doc/zh/analytics/content/data-collection/attribution-integration.md)。 * 修复了一个问题，该问题会阻止保存和发送事件到服务器的日志记录。 ### Version 6.1.0 {#s-6-1-0} 2023年11月28日发布 * 已将 `buildToolsVersion` 提升至 `34.0.0`. * 已将 `targetSdkVersion` 和 `compileSdkVersion` 提升至 `34`. * Kotlin 插件已更新至版本 `org.jetbrains.kotlin:kotlin-gradle-plugin:1.6.21`. * 现在支持[自动收集购买和订阅](https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-revenue.md)，使用`com.android.billingclient:billing:6.0.0`库。 使用 `com.android.billingclient:billing:4.+` 库自动收集购买和订阅的功能已不再支持。 自动收集购买和订阅现已支持 `com.android.billingclient:billing:5.0.0` 及更高版本。 关于[发送收入](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-revenue)的更多详情。 * 已修复可能的死锁 `在 io.appmetrica.analytics.networktasks.internal.NetworkCore.onDestroy`。 ### Version 6.0.0 {#s-6-0-0} 2023年9月13日发布 * 已更新库 ID、根包和 API。 要了解更多详情，请查看[迁移说明](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/migration-io-6-0-0.md)。 * 移除 Breakpad 集成。 目前仅使用 Crashpad。 要捕获本地崩溃，请使用 `io.appmetrica.analytics:analytics-ndk-crashes:3.0.0` 依赖项。 要了解更多详情，请查看关于[本地崩溃](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#native-crashes)的部分。 * 将权限 `com.google.android.gms.permission.AD_ID` 移至 `io.appmetrica.analytics:analytics-identifiers` 模块。 * 修复了 `类 io.appmetrica.analytics.impl.ob.Zh 锁验证失败，运行速度会降低` 的警告（以及安装和启动应用时可能出现的类似警告）。 * 已修复在`io.appmetrica.analytics.impl.ob.p3$b.onServiceConnected(SourceFile:2)`处可能的 ANR 错误。 * 将地理功能移至单独的依赖项：`io.appmetrica.analytics:analytics-location`. 您现在可以在需要时选择在应用构建阶段让 AppMetrica SDK 不收集位置坐标。 对于某些应用类别，这可能是遵守 Google Play 政策的要求。 要了解更多信息，请查看[文档](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/geo-exclude.md)。 * 现在支持 API 用于获取 AppMetrica SDK ID（`DeviceId`、`DeviceIdHash`、`UUID`），使用 `AppMetrica#requestStartupParams` 方法。 要了解更多信息，请查看[文档](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#get-ids)。 * 现在支持通过API指定设备类型（手机、平板、电视、汽车）。 要了解更多信息，请查看[文档](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#device-type)。 ### Version 5.3.0 {#s-5-3-0} 2023年3月3日发布。 * 修复了 `类 com.yandex.metrica.impl.ob.Zh 锁验证失败，运行速度会降低` 的警告（以及安装和启动应用时可能出现的类似警告）。 * 已修复可能的 ANR `在 com.yandex.metrica.impl.ob.p3$b.onServiceConnected(SourceFile:2)`。 * 修复了错误并提高了稳定性。 ### Version 5.2.0 {#s-5-2-0} 2022年9月19日发布 * 添加了 AdRevenue API，用于传输广告赚取收入数据（按展示级别的收入数据）： * `广告收入`和`广告收入构建器`类。 * `reportAdRevenue(AdRevenue adRevenue)` 方法在 `YandexMetrica` 类中，以及 `reportAdRevenue(AdRevenue adRevenue)` 方法在 `IReporter` 接口中。 * The `广告类型` 枚举。 要了解更多详情，请查看[发送广告收入](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue)和[广告收入](https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-adrevenue.md)。 * targetSdkVersion = 33. ### Version 5.0.1 {#s-5-0-1} 2022年7月29日发布 * 修复了可能导致重复伪安装的问题。 ### Versions 5.0.0–4.0.0 {% cut "5.0.0–4.0.0" %} #### Version 5.0.0 {#s-5-0-0} 2022年5月20日发布 {% note info %} 从 Android AppMetrica SDK 5.0.0 版本开始，appmetrica_device_id 在应用重新安装时会发生变化。 这是由于 Google 的新政策。 要了解更多信息，请查看[文档](https://boost.yandex.com/doc/zh/analytics/content/troubleshooting/troubleshooting.md#change-device-id)。 {% endnote %} * 将获取广告 ID 的功能移至单独的库，命名为`com.yandex.android:mobmetricalib-identifiers`. 要了解更多信息，请参见[获取广告 ID](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/get-ad-id.md)。 * 默认情况下，发送设备位置信息的标志已被禁用。 要启用与事件一起发送位置数据，请使用以下方法之一：`withLocationTracking(boolean enabled)` 或 `setLocationTracking(boolean enabled)`. 要了解更多详情，请查看[使用库发送设备位置](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#track-location)和[确定位置](https://boost.yandex.com/doc/zh/analytics/content/data-collection/geo.md)。 * 为 `DeferredDeeplinkParametersListener` 接口方法的参数添加了 @NonNull 注解。 * 方法 `reportNativeCrash` 已弃用，将在未来版本中删除。 #### Version 4.2.0 {#s-4-2-0} 2022年2月17日发布 * 添加了一个新 API，用于跟踪来自随机插件的崩溃和错误。 Interfaces: * YandexMetricaPlugins; * IPluginReporter. Classes: * PluginErrorDetails; * PluginErrorDetails.Builder; * StackTraceItem; * StackTraceItem.Builder. * 现在支持降级到 4.2.0 版本或更高版本，并保留重要数据（例如设备 ID）。 不建议降级，因为这可能导致数据丢失和损坏。 对于这样的用户，重复归因将不被支持。 * 现在支持 Google Play Billing Library 4.0.0 版本。 版本3.x仍提供支持。 要了解更多关于[应用内购买](https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-revenue.md)的详情。 * 在 `DeferredDeeplinkParametersListener` 方法中，`referrer` 参数变为 `@NonNull`. 如果缺失，你会得到一个空字符串。 * 在运行 Android 12 或更高版本的设备上移除 ROOT 状态检测。 现在所有运行 Android 12 的设备都将被视为没有 ROOT 权限的设备。 * 修复了错误并提高了稳定性： * 修复了尝试连接到 MetricaService 时可能出现的崩溃问题： ``` Process: com.yandex :Metrica java.lang.RuntimeException: 无法绑定到服务 com.yandex.metrica.MetricaService 原因: java.lang.IllegalArgumentException at android.os.Parcel.nativeAppendFrom(Native Method). ``` * 修复了进程中可能出现的ANR： ``` Metrica: at com.yandex.metrica.impl.ob.jg.a (jg.java) at com.yandex.metrica.MetricaService.onConfigurationChanged(MetricaService.java:2) ``` * 修复了可能的崩溃： ``` java.lang.NullPointerException: 尝试从空数组读取 at com.yandex.metrica.impl.ob.tz.a ``` #### Version 4.1.1 {#s-4-1-1} 2021年12月17日发布 * Added [com.google.android.gms.permission.AD_ID](https://support.google.com/googleplay/android-developer/answer/6048248#zippy%3D%252Cpersistent-identifiers-including-android-id%252Ctargeting-devices-without-an-advertising-id%252Cadvertising-id-violations%252Chow-to-opt-out-of-personalized-ads) 权限。 要了解更多信息，请查看[文档](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/get-ad-id.md)。 * 在 `DeferredDeeplinkListener.Error` 和 `DeferredDeeplinkParametersListener.Error` 中添加了 `NO_REFERRER` 值。 为从 Google Play 获取来源已添加对 [App Set ID](https://developer.android.com/training/articles/app-set-id) 的初步支持（依赖 `com.google.android.gms:play-services-appset:16.0.0`）。 * SDK 优化得到支持，因为修复了类初始化时可能出现的 [VerifyError](https://source.chromium.org/chromium/chromium/src/+/master:build/android/docs/class_verification_failures.md;bpv=1;bpt=0)。 * Mac地址收集已禁用。 #### Version 4.0.0 {#s-4-0-0} 2021年9月20日发布 * Google Play 安装来源（通过 BroadcastReceiver）不再支持： * 已从 AndroidManifest 中移除 `MetricaEventHandler` * 已删除 `YandexMetrica#registerReferrerBroadcastReceivers` 方法。 * 移除了 `YandexMetricaConfig#installedAppCollecting` 标志。 * 删除了 `YandexMetricaConfig.Builder#withInstalledAppCollecting` 方法。 * 添加了 `YandexMetricaConfig.Builder#withSessionsAutoTrackingEnabled(boolean enabled)` 方法用于 [自动跟踪会话](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-listen.md)。 * 添加了 `revenueAutoTrackingEnabled` 方法，用于 [自动收集应用内购买数据](https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-revenue.md)。 * 现在支持在[Google Play SDK Console](https://support.google.com/googlepl..-developer/answer/10358880?hl=ru)发布“.module”文件。 * [深链自动跟踪](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#deeplink)已实现并默认启用。 要了解更多详情，请查看[深链追踪](https://boost.yandex.com/doc/zh/analytics/content/data-collection/deeplinks.md)。 * AppMetrica SDK [已迁移到 AndroidX](https://developer.android.com/jetpack/androidx/migrate). * 已为 Android 12 添加基本支持：当 app 的 targetSdkVersion = 31 时，AppMetrica SDK 的主要功能在 Android 12 设备上可用。 * minSdkVersion 已升级至 14。 {% endcut %} ## AppMetrica Gradle 插件 要了解更多设置详情，请查看[AppMetricaGradle Plugin](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-gradle-plugin.md)和[在 Android 上上传映射文件和调试符号](https://boost.yandex.com/doc/zh/analytics/content/data-collection/upload-mapping.md)。 ### Version 2.1.0 {#c-2-1-0} Release June 17, 2026 - 为 Kotlin DSL 正确配置插件添加了扩展。 - 修复了导致 Java 系统属性被忽略的问题。 ### Version 2.0.1 {#c-2-0-1} Release 2026年3月16日 - 插件的性能已得到提升。 只有插件启用时，生成资源的任务才会启用。 ### Version 2.0.0 {#c-2-0-0} Release 2026年3月3日 - 重构的插件配置扩展。 - 任务已重构以支持 Gradle 配置缓存。 - 已添加对 AGP 最高至版本 `8.13.+`（不包括 `8.0.+`）以及 Gradle 最高至 `9.2.1` 的支持。 - 本地 [符号上传](https://boost.yandex.com/doc/zh/analytics/content/data-collection/upload-mapping.md) 任务现在在构建应用程序后会自动触发。 - 已停止支持AGP 4。 - 修复了混淆器类型检测。 - Removed potential `无效的 cookie 头` 警告。 ### Version 1.3.0 {#c-1-3-0} Release 2025年8月18日 - 已将 `analytics-ndk-crashes` 插件版本更新至 `3.1.0`。 - 已添加对AGP最高至`8.12.+`版本的支持（不包括`8.0.+`），以及对Gradle最高至`8.13`的支持. ### Version 1.2.0 {#c-1-2-0} 2025年7月15日发布 - Fixed `NegativeArraySizeException` 错误。 - 增强的日志功能。 - 已添加对 AGP 版本最高至 `8.8.+`（不包括 `8.0.+`）以及 Gradle 最高至 `8.12` 的支持。 - 修复了AGP版本检测。 ### Version 1.0.1 {#c-1-0-1} 2024年12月4日发布 * 修复了 `version_name` 字段在 `info.txt` 文件中的值。 ### Version 1.0.0 {#c-1-0-0} 2024年11月27日发布 * 插件连接支持使用`pluginManagement`。 插件已更名为`io.appmetrica.analytics`. * 插件中的所有操作都在单独的 Gradle 任务中执行。 * 插件支持的 Gradle 和 AGP 版本列表已更改。 * 插件正常工作需要启用配置缓存。 * 修复了在某些 `R8` 设置下导致必要资源被删除的错误。 ### Version 0.11.0 {#c-0-11-0} 2024年5月2日发布 * Fixed the error `无法将文件写入指向目录的位置` * 已停止使用已 `弃用` 的 `VersionNumber` 类。 ### Version 0.10.0 {#c-0-10-0} 2024年4月26日发布 * 为插件添加了AGP `8.2.+` 添加的资源的`保留`. ### Version 0.9.0 {#c-0-9-0} 2024年2月26日发布 * 现在支持AGP至版本`8.2.+`（不包括`8.0.+`）和gradle至`8.6`. ### Version 0.8.2 {#c-0-8-2} 2023年10月31日发布 * 修复了由于循环依赖而出现的`StackOverflowError`错误。 ### Version 0.8.1 {#c-0-8-1} 2023年10月4日发布 * 修复了在项目中有多个模块时检查使用两个 AppMetrica 版本可能导致的崩溃。 ### Version 0.8.0 {#c-0-8-0} 2023年9月14日发布 * 已将插件名称更改为 `io.appmetrica.analytics:gradle:0.8.0`。 * 依赖项 `com.yandex.android:mobmetricalib-ndk-crashes:1.1.0` 已更新至 `io.appmetrica.analytics:analytics-ndk-crashes:3.0.0`. * 现在支持 `io.appmetrica.analytics:analytics:6.0.0`. * 添加了 `allowTwoAppMetricas` 参数，以禁用检查使用不同 AppMetrica 版本的功能。 ### Version 0.7.0 {#c-0-7-0} 2023年4月19日发布 * 错误报告中添加了更多关于映射文件缺失的详细信息。 * 现在支持AGP至版本`7.4.+`和gradle至`7.5`. ### Version 0.6.2 {#c-0-6-2} 2022年7月28日发布 * 插件性能得到提升。 ### Version 0.6.1 {#c-0-6-1} 2022年5月20日发布 * 插件性能得到提升。 ### Version 0.6.0 {#c-0-6-0} 2022年5月17日发布 * 添加了 mappingFile 参数。 * 修复了在检索映射文件时出现的“无法查询此属性的值，因为没有可用的值”错误。 ## AppMetrica 推送 SDK 要了解更多设置详情，请参见[安装和初始化](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/push/quick-start.md)。 要查看模块列表，请参见[Push SDK 可选模块列表](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/push/android-modules-push.md)。 ### Version 4.3.0 {#v-4-3-0} 发布于2026年3月26日 - 已删除`插件适配器`模块。 相反，使用的是 AppMetrica SDK 的匿名激活——使用先前保存的配置进行激活，前提是应用尚未自行完成激活。 要了解更多详情，请参见[安装和初始化](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/push/quick-start.md)。 - 已添加对 AppMetrica SDK 的自动激活，以简化服务中的事件处理。 这会提升 Push SDK 事件的送达率，因为它消除了在初始化 Push SDK 和 AppMetrica SDK 过程中可能出现的竞争条件。 - AppMetrica SDK 的最低版本已提升至 `7.1.0`。 - `org.jetbrains.kotlin:kotlin-stdlib` 的版本已更新至 `1.9.25`。 - JVM 目标版本已更新至 `1.8`. - `targetSdkVersion` 和 `compileSdkVersion` 已提升至 `36`. ### Version 4.2.1 {#v-4-2-1} 2025年9月13日发布 - AppMetrica 已加速 Push SDK 的激活。 - 类`AppMetricaPushTracker`已标记为`过时`，请使用`AppMetricaPush.reportPushEvent`代替。 - 方法`AppMetricaPush.addPushMessageTracker(PushMessageTracker)`已标记为`过时`，请使用`AppMetricaPush.addPushEventListener`代替。 - 操作的URI已添加到`自定义`和`打开`事件中。 - 已更新了验证兼容性的依赖版本列表。 ### Version 4.1.1 {#v-4-1-1} 2025年1月25日发布 - 修复了 `PushServiceController.shouldSendToken` 方法的行为。 当 `shouldSendToken == false` 或 `token == null` 时，令牌将不再发送。 - 依赖 `androidx.legacy:legacy-support-v4` 已被替换为 `androidx.core:core`. ### Version 4.0.0 {#v-4-0-0} 2024年7月11日发布 - 当前的 `minSdkVersion` 已升级为 `21`（Android 5.0）。 - 已将 `AppMetricaPushTracker` 构造函数从 `AppMetricaPushTracker()` 更改为 `AppMetricaPushTracker(Context)`。 - 更新了`PushServiceController`接口： - 将 `getTitle` 方法重命名为 `getTransportId`. - 添加了 `getExecutionRestrictions` 和 `shouldSendToken` 方法。 - 提高了推送通知的处理速度和发送效率。 ### Version 3.3.0 {#v-3-3-0} 2024年5月3日发布 - 修复了 `plugin-adapter` 中推送通知的处理。 ### Version 3.2.0 {#v-3-2-0} 2024年4月22日发布 - 已更新支持的 RuStore 版本至 `ru.rustore.sdk:pushclient:2.1.1` 要了解模块的更多详情，请参见[Push SDK 可选模块列表](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/push/android-modules-push.md)。 - 添加了 `plugin-adapter` 模块，以确保在插件中使用 Push SDK 时性能正常。 要了解更多详情，请查看[Push SDK 可选模块列表](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/push/android-modules-push.md)。 - 公共 API 已添加支持保存变量名称的功能。 ### Version 3.1.1 {#v-3-1-1} 2024年4月9日发布 - 删除调试日志。 ### Version 3.1.0 {#v-3-1-0} 2024年4月2日发布 - 修复了在通知被禁用时静默推送通知的发送问题。 ### Versions 3.0.0–2.0.0 {% cut "3.0.0–2.0.0" %} #### Version 3.0.0 {#v-3-0-0} 2023年11月18日发布 - 已更新库 ID、根包和 API。 要了解更多详情，请查看[迁移说明](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/push/migration-io-3-0-0.md)。 - 添加了用于自定义 SDK 创建的通知的 API。 - 已移除 `com.yandex.android:mobmetricalib` 支持。 #### Version 2.3.3 {#v-2-3-3} 2023年11月10日发布 - 修复了当应用同时运行两个不同版本的 AppMetrica SDK 时发生的崩溃问题。 #### Version 2.3.2 {#v-2-3-2} 2023年10月4日发布 - 修复了一个 bug ``` 没有 Lio/appmetrica/analytics/ModuleEvent$Companion 类型的 Companion 字段 ``` #### Version 2.3.1 {#v-2-3-1} 2023年7月31日发布 - 库性能和稳定性得到提升。 #### Version 2.2.0 {#v-2-2-0} 2022年6月2日发布 - `minSdkVersion`（在 `appmetricapush-provider-hms`）已提升至17。 - `Hms` 已更新至版本 6.5.0.300。 - 加速PushSDK激活。 #### Version 2.1.1 {#v-2-1-1} 2022年3月14日发布 - Fixed a bug `BadParcelableException：Parcelable 协议需要一个名为 CREATOR 的 Parcelable.Creator 对象`. #### Version 2.1.0 {#v-2-1-0} 2022年2月24日发布 - 令令牌获取更优化。 - 当从 TokenUpdateListener.onTokenUpdated 调用时，YandexMetricaPush.getTokens 方法会返回新的令牌。 - 库的性能和稳定性得到了提升。 #### Version 2.0.0 {#v-2-0-0} 2021年10月28日发布 - 修复了在 Android 12 中处理推送点击时偶尔出现的错误。 - 从支持依赖切换到 AndroidX。 {% endcut %} ## AppMetrica NDK 崩溃 要了解有关捕获本地崩溃的更多详情，请参见[监控本地应用崩溃](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#native-crashes)。 ### Version 3.1.0 {#ndk-3-1-0} Release 2025年7月30日 - 已将 Crashpad 更新至 [46a5690fc061117f00dd48920de7b13c7db29da4](https://chromium.googlesource.com/crashpad/crashpad/+/46a5690fc061117f00dd48920de7b13c7db29da4) 提交。 - 添加了对[16 KB页面大小](https://developer.android.com/guide/practices/page-sizes)的支持（在.so文件中） ### Version 3.0.0 {#ndk-3-0-0} Release 2023年9月13日 - 已将 Crashpad 更新至提交 [9158eb7caa811b684c6bec7f9e9b5f52389d0ce0](https://chromium.googlesource.com/crashpad/crashpad/+/9158eb7caa811b684c6bec7f9e9b5f52389d0ce0). 要捕获本地崩溃，请使用 `io.appmetrica.analytics:analytics-ndk-crashes:3.0.0` 依赖项。 要了解更多详情，请查看关于[本地崩溃](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#native-crashes)的部分。