更新日志

AppMetrica SDK

Version 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

Release 2026年7月18日

  • 修复了空会话的数据发送问题。

Version 8.4.0

Release July 16, 2026

  • 添加了新模块 io.appmetrica.analytics:analytics-product-flow 和 API，用于 跟踪产品场景和推广事件。 要了解更多关于该方法的详情，请查看在产品场景中提供事件。
  • Fixed ReporterConfig.Builder.withAppEnvironmentValue 未应用到创建的次级报告器上。
  • 修复了在调用 registerReceiver 时可能出现的崩溃。
  • 将用于分割日志中长字符串的正则表达式的初始化延迟到第一次使用时。

Version 8.3.2

Release 2026年8月10日

  • 修复了由于为每个网络请求创建新的OkHttpClient而导致的空闲OkHttp连接逐渐累积的问题：现在客户端会重用共享的ConnectionPool和Dispatcher.

Version 8.3.1

Release 2026年7月18日

  • 修复了空会话的数据发送问题。

Version 8.3.0

Release June 5, 2026

Version 8.2.0

Release May 14, 2026

Version 8.1.0

发布日期：2026年4月13日

  • Bumped targetSdkVersion 和 compileSdkVersion 到 36.
  • 已将 org.jetbrains.kotlin:kotlin-stdlib 更新至 1.9.25。
  • JVM 目标版本已更新至 1.8.
  • 调整了 安装来源 的发送逻辑：现在安装来源会从与应用安装程序匹配的源发送。
  • 如果有 deviceId 值，AppMetrica.getDeviceID() 现在会在不进行激活的情况下返回该值。 Otherwise, null 被返回。 要了解获取 ID 的更多详情，请参阅文档。
  • 在某些边界情况下修复了可能的 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操作次数和写入的数据量。
  • 优化获取广告标识符。

Version 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

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

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

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。

Version 7.14.1

Release December 28, 2025

  • 修复在数据发送被禁用时数据库达到限制时自动清除事件的问题。
  • 在 analytics-id-sync 模块中添加了实时数据发送功能。

Version 7.14.0

Release November 26, 2025

Version 7.13.0

Release 2025年10月17日

  • 已添加新模块 analytics-id-sync. 该模块提供了与多个用户标识提供商进行工作的基础架构，支持对匿名观众进行定位和标识合并，同时保障用户隐私。 该模块增强了集成能力，并提升了跨平台环境下系统的总体性能。
  • 添加了新模块 analytics-billing。 该模块聚合了应用内购买收集功能，并允许您在必要时排除它。
  • 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

Release 2025年9月4日

  • Changed the ironsource artifact to com.unity3d.ads-mediation:mediation-sdk for 广告收入 collecting.
  • 更新了依赖版本列表，用于检查兼容性。

Version 7.11.0

Release 2025年8月21日

  • 添加了对 Google Play Billing Library v8 的完整支持。 关于发送收入和应用内购买的更多详情。
  • 改进了 设备类型 的 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

Release 2025年7月11日

  • 当数据发送被禁用时，添加了禁止库发送任何网络请求的限制。 之前可以发送网络配置请求。

  • 修复了崩溃后会话可能未完成的问题。

  • 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

Release 2025年5月8日

  • AppMetrica SDK 的主要组件已移至主应用程序进程。 SDK AppMetrica 现在已在主应用程序进程中完全运行。 完全避免单独的进程可以消除与其他库（例如 Firebase Performance）集成可能出现的问题。
  • 添加了对插件广告收入数据未来自动收集的支持。
  • 修复了可能的ANR：
    • at com.android.billingclient.api.BillingClientImpl.zzaJ(BillingClientImpl.java:1) (issue#19).
    • at io.appmetrica.analytics.impl.Uf.onInstallReferrerSetupFinished(Uf.java:3) (issue#20).

Version 7.8.0

Release April 9, 2025

  • 已添加可选模块 io.appmetrica.analytics:analytics-screenshot。 它会检测用户是否截取了屏幕。 当检测到时，会发送客户端事件appmetrica_system_event_screenshot。 为了正确工作，需要在 AndroidManifest.xml 中添加权限 android.permission.DETECT_SCREEN_CAPTURE。 要了解模块的更多详情，请查看模块列表。
  • 修复了可能导致自动收集的应用内购买数据重复的问题。
  • 修复了一个问题，该问题可能会导致非常旧的应用内购买用当前日期自动收集，从而可能扭曲报告。
  • 依赖更新：

    • 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

  • 添加了管理对广告标识符的访问权限的能力到AppMetricaLibraryAdapter。

Version 7.7.0

Release 2025年2月14日

  • 在广告收入模块中将Apphud SDK更新至2.8.4版本。

  • 有关原始广告类型的信息已添加到广告收入事件中。

  • 为来自 AdMob SDK 的广告收入事件添加了 APP_OPEN 类型。

  • 已修复可能的 ANR:

    • at io.appmetrica.analytics.impl.nm.onDestroy(nm.java:1) (issue#16).
    • at io.appmetrica.analytics.networktasks.internal.NetworkCore.stopTasks(NetworkCore.java:1) (issue#17).

Version 7.6.0

2025年1月23日发布

  • 修复了使用 AppMetrica 插件（Unity、Flutter、ReactNative）和 Yandex Ads 插件同时运行时可能出现的统计问题（安装和新用户）。
  • 修复了在激活前访问 AppMetrica API 时可能出现的 ANR。

Version 7.5.0

2024年12月5日发布

  • 添加了用于管理访问广告标识符（GAID、Huawei OAID）的API。 查看文档。

Version 7.4.0

2024年11月29日发布

  • 已优化来源处理机制，从而修复了通过跟踪链接在最新版 Chromium 引擎浏览器（如 Google Chrome、Yandex 浏览器等）安装应用时收到 延迟深链 及其参数的错误。

Version 7.3.0

2024年11月5日发布

  • 添加了 AppMetrica#reportAnr() 和 IReporter#reportAnr() 方法，允许您手动发送 ANR 数据。
  • 修复了可能的 java.lang.IllegalArgumentException:... at io.appmetrica.analytics.impl.K7.a(K7.java:27) 崩溃。
  • 修复了在应用构建过程中出现的 缺失类 com.google.android.gms.ads.AdValue 警告（issue#10）。

Version 7.2.2

2024年10月23日发布

  • 添加了额外的检查，以验证 AppMetrica SDK 初始化已完成。

Version 7.2.1

2024年10月3日发布

  • 优化了通过第三方库适配器激活 AppMetrica SDK 时对非首次启动应用的检测。
  • 如果您在第三方库适配器激活前发送事件，或者使用无效参数发送事件，现在这些事件将被忽略，而不是抛出异常。

Version 7.2.0

2024年9月11日发布

  • 取消了用于检测 AppMetrica SDK 和 AppMetrica Push SDK 内部崩溃的本地机制，改用后端解决方案。

  • 已添加 io.appmetrica.analytics:analytics-apphud 模块以进行 Apphud 集成。 要了解更多详情，请参见Boost和Apphud。

  • 添加了一个 API，以简化从 Google AdMob 发送广告展示级收入数据（ILRD）的流程，针对“App open ad”广告格式。

  • 事件日志功能改进。

Version 7.1.0

2024年8月21日发布

  • 添加了一个API，以便从以下位置发送ILRD（展现级收入数据）：
  • 添加了对部分事件的加速发送支持（来自外部 SDK 的归因、电子商务、收入以及广告收入（广告展示级别的收入数据）``）到服务器。

Version 7.0.0

发布于2024年6月28日

重大变更：

  • 当前的 minSdkVersion 已升级为 21（Android 5.0）。
  • 源兼容性（sourceCompatibility）和目标兼容性（targetCompatibility）版本已升级到 Java 1.8。

额外的更改：

  • 为崩溃和错误报告添加了无效格式纠正。 此变更解决了潜在的崩溃问题

    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.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

2024年4月26日发布

Version 6.4.0

2024年4月11日发布

Version 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)。
  • 修复了发送外部归因时可能导致崩溃的问题 (org.json.JSONException: Forbidden numeric value: NaN，AppMetrica#reportExternalAttribution(...)``)。

Version 6.2.1

2024年1月26日发布

  • 修复了外部归因序列化的错误。

Version 6.2.0

2024年1月22日发布

  • 添加了 AppMetrica.reportExternalAttribution 方法，用于从外部库发送归因数据。 要了解更多，请查看从其他 SDK 导入归因。
  • 修复了一个问题，该问题会阻止保存和发送事件到服务器的日志记录。

Version 6.1.0

2023年11月28日发布

  • 已将 buildToolsVersion 提升至 34.0.0.
  • 已将 targetSdkVersion 和 compileSdkVersion 提升至 34.
  • Kotlin 插件已更新至版本 org.jetbrains.kotlin:kotlin-gradle-plugin:1.6.21.
  • 现在支持自动收集购买和订阅，使用com.android.billingclient:billing:6.0.0库。 使用 com.android.billingclient:billing:4.+ 库自动收集购买和订阅的功能已不再支持。 自动收集购买和订阅现已支持 com.android.billingclient:billing:5.0.0 及更高版本。 关于发送收入的更多详情。
  • 已修复可能的死锁 在 io.appmetrica.analytics.networktasks.internal.NetworkCore.onDestroy。

Version 6.0.0

2023年9月13日发布

  • 已更新库 ID、根包和 API。 要了解更多详情，请查看迁移说明。
  • 移除 Breakpad 集成。 目前仅使用 Crashpad。 要捕获本地崩溃，请使用 io.appmetrica.analytics:analytics-ndk-crashes:3.0.0 依赖项。 要了解更多详情，请查看关于本地崩溃的部分。
  • 将权限 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 政策的要求。 要了解更多信息，请查看文档。
  • 现在支持 API 用于获取 AppMetrica SDK ID（DeviceId、DeviceIdHash、UUID），使用 AppMetrica#requestStartupParams 方法。 要了解更多信息，请查看文档。
  • 现在支持通过API指定设备类型（手机、平板、电视、汽车）。 要了解更多信息，请查看文档。

Version 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

2022年9月19日发布

  • 添加了 AdRevenue API，用于传输广告赚取收入数据（按展示级别的收入数据）：

    • 广告收入和广告收入构建器类。
    • reportAdRevenue(AdRevenue adRevenue) 方法在 YandexMetrica 类中，以及 reportAdRevenue(AdRevenue adRevenue) 方法在 IReporter 接口中。
    • The 广告类型 枚举。

    要了解更多详情，请查看发送广告收入和广告收入。

  • targetSdkVersion = 33.

Version 5.0.1

2022年7月29日发布

  • 修复了可能导致重复伪安装的问题。

Versions 5.0.0–4.0.0

5.0.0–4.0.0

Version 5.0.0

2022年5月20日发布

备注

从 Android AppMetrica SDK 5.0.0 版本开始，appmetrica_device_id 在应用重新安装时会发生变化。 这是由于 Google 的新政策。 要了解更多信息，请查看文档。

  • 将获取广告 ID 的功能移至单独的库，命名为com.yandex.android:mobmetricalib-identifiers. 要了解更多信息，请参见获取广告 ID。
  • 默认情况下，发送设备位置信息的标志已被禁用。 要启用与事件一起发送位置数据，请使用以下方法之一：withLocationTracking(boolean enabled) 或 setLocationTracking(boolean enabled). 要了解更多详情，请查看使用库发送设备位置和确定位置。
  • 为 DeferredDeeplinkParametersListener 接口方法的参数添加了 @NonNull 注解。
  • 方法 reportNativeCrash 已弃用，将在未来版本中删除。

Version 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仍提供支持。 要了解更多关于应用内购买的详情。

  • 在 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

2021年12月17日发布

  • Added com.google.android.gms.permission.AD_ID 权限。 要了解更多信息，请查看文档。
  • 在 DeferredDeeplinkListener.Error 和 DeferredDeeplinkParametersListener.Error 中添加了 NO_REFERRER 值。 为从 Google Play 获取来源已添加对 App Set ID 的初步支持（依赖 com.google.android.gms:play-services-appset:16.0.0）。
  • SDK 优化得到支持，因为修复了类初始化时可能出现的 VerifyError。
  • Mac地址收集已禁用。

Version 4.0.0

2021年9月20日发布

  • Google Play 安装来源（通过 BroadcastReceiver）不再支持：

    • 已从 AndroidManifest 中移除 MetricaEventHandler
    • 已删除 YandexMetrica#registerReferrerBroadcastReceivers 方法。
    • 移除了 YandexMetricaConfig#installedAppCollecting 标志。
    • 删除了 YandexMetricaConfig.Builder#withInstalledAppCollecting 方法。

  • 添加了 YandexMetricaConfig.Builder#withSessionsAutoTrackingEnabled(boolean enabled) 方法用于 自动跟踪会话。

  • 添加了 revenueAutoTrackingEnabled 方法，用于 自动收集应用内购买数据。

  • 现在支持在Google Play SDK Console发布“.module”文件。

  • 深链自动跟踪已实现并默认启用。 要了解更多详情，请查看深链追踪。

  • AppMetrica SDK 已迁移到 AndroidX.

  • 已为 Android 12 添加基本支持：当 app 的 targetSdkVersion = 31 时，AppMetrica SDK 的主要功能在 Android 12 设备上可用。

  • minSdkVersion 已升级至 14。

AppMetrica Gradle 插件

要了解更多设置详情，请查看AppMetricaGradle Plugin和在 Android 上上传映射文件和调试符号。

Version 2.1.0

Release June 17, 2026

  • 为 Kotlin DSL 正确配置插件添加了扩展。
  • 修复了导致 Java 系统属性被忽略的问题。

Version 2.0.1

Release 2026年3月16日

  • 插件的性能已得到提升。 只有插件启用时，生成资源的任务才会启用。

Version 2.0.0

Release 2026年3月3日

  • 重构的插件配置扩展。
  • 任务已重构以支持 Gradle 配置缓存。
  • 已添加对 AGP 最高至版本 8.13.+（不包括 8.0.+）以及 Gradle 最高至 9.2.1 的支持。
  • 本地 符号上传 任务现在在构建应用程序后会自动触发。
  • 已停止支持AGP 4。
  • 修复了混淆器类型检测。
  • Removed potential 无效的 cookie 头 警告。

Version 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

2025年7月15日发布

  • Fixed NegativeArraySizeException 错误。
  • 增强的日志功能。
  • 已添加对 AGP 版本最高至 8.8.+（不包括 8.0.+）以及 Gradle 最高至 8.12 的支持。
  • 修复了AGP版本检测。

Version 1.0.1

2024年12月4日发布

  • 修复了 version_name 字段在 info.txt 文件中的值。

Version 1.0.0

2024年11月27日发布

  • 插件连接支持使用pluginManagement。 插件已更名为io.appmetrica.analytics.
  • 插件中的所有操作都在单独的 Gradle 任务中执行。
  • 插件支持的 Gradle 和 AGP 版本列表已更改。
  • 插件正常工作需要启用配置缓存。
  • 修复了在某些 R8 设置下导致必要资源被删除的错误。

Version 0.11.0

2024年5月2日发布

  • Fixed the error 无法将文件写入指向目录的位置
  • 已停止使用已 弃用 的 VersionNumber 类。

Version 0.10.0

2024年4月26日发布

  • 为插件添加了AGP 8.2.+ 添加的资源的保留.

Version 0.9.0

2024年2月26日发布

  • 现在支持AGP至版本8.2.+（不包括8.0.+）和gradle至8.6.

Version 0.8.2

2023年10月31日发布

  • 修复了由于循环依赖而出现的StackOverflowError错误。

Version 0.8.1

2023年10月4日发布

  • 修复了在项目中有多个模块时检查使用两个 AppMetrica 版本可能导致的崩溃。

Version 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

2023年4月19日发布

  • 错误报告中添加了更多关于映射文件缺失的详细信息。
  • 现在支持AGP至版本7.4.+和gradle至7.5.

Version 0.6.2

2022年7月28日发布

  • 插件性能得到提升。

Version 0.6.1

2022年5月20日发布

  • 插件性能得到提升。

Version 0.6.0

2022年5月17日发布

  • 添加了 mappingFile 参数。
  • 修复了在检索映射文件时出现的“无法查询此属性的值，因为没有可用的值”错误。

AppMetrica 推送 SDK

要了解更多设置详情，请参见安装和初始化。 要查看模块列表，请参见Push SDK 可选模块列表。

Version 4.3.0

发布于2026年3月26日

  • 已删除插件适配器模块。 相反，使用的是 AppMetrica SDK 的匿名激活——使用先前保存的配置进行激活，前提是应用尚未自行完成激活。 要了解更多详情，请参见安装和初始化。
  • 已添加对 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

2025年9月13日发布

  • AppMetrica 已加速 Push SDK 的激活。
  • 类AppMetricaPushTracker已标记为过时，请使用AppMetricaPush.reportPushEvent代替。
  • 方法AppMetricaPush.addPushMessageTracker(PushMessageTracker)已标记为过时，请使用AppMetricaPush.addPushEventListener代替。
  • 操作的URI已添加到自定义和打开事件中。
  • 已更新了验证兼容性的依赖版本列表。

Version 4.1.1

2025年1月25日发布

  • 修复了 PushServiceController.shouldSendToken 方法的行为。 当 shouldSendToken == false 或 token == null 时，令牌将不再发送。
  • 依赖 androidx.legacy:legacy-support-v4 已被替换为 androidx.core:core.

Version 4.0.0

2024年7月11日发布

  • 当前的 minSdkVersion 已升级为 21（Android 5.0）。
  • 已将 AppMetricaPushTracker 构造函数从 AppMetricaPushTracker() 更改为 AppMetricaPushTracker(Context)。
  • 更新了PushServiceController接口：
    • 将 getTitle 方法重命名为 getTransportId.
    • 添加了 getExecutionRestrictions 和 shouldSendToken 方法。
  • 提高了推送通知的处理速度和发送效率。

Version 3.3.0

2024年5月3日发布

  • 修复了 plugin-adapter 中推送通知的处理。

Version 3.2.0

2024年4月22日发布

  • 已更新支持的 RuStore 版本至 ru.rustore.sdk:pushclient:2.1.1 要了解模块的更多详情，请参见Push SDK 可选模块列表。
  • 添加了 plugin-adapter 模块，以确保在插件中使用 Push SDK 时性能正常。 要了解更多详情，请查看Push SDK 可选模块列表。
  • 公共 API 已添加支持保存变量名称的功能。

Version 3.1.1

2024年4月9日发布

  • 删除调试日志。

Version 3.1.0

2024年4月2日发布

  • 修复了在通知被禁用时静默推送通知的发送问题。

Versions 3.0.0–2.0.0

3.0.0–2.0.0

Version 3.0.0

2023年11月18日发布

  • 已更新库 ID、根包和 API。 要了解更多详情，请查看迁移说明。
  • 添加了用于自定义 SDK 创建的通知的 API。
  • 已移除 com.yandex.android:mobmetricalib 支持。

Version 2.3.3

2023年11月10日发布

  • 修复了当应用同时运行两个不同版本的 AppMetrica SDK 时发生的崩溃问题。

Version 2.3.2

2023年10月4日发布

  • 修复了一个 bug

    没有 Lio/appmetrica/analytics/ModuleEvent$Companion 类型的 Companion 字段

Version 2.3.1

2023年7月31日发布

  • 库性能和稳定性得到提升。

Version 2.2.0

2022年6月2日发布

  • minSdkVersion（在 appmetricapush-provider-hms）已提升至17。
  • Hms 已更新至版本 6.5.0.300。
  • 加速PushSDK激活。

Version 2.1.1

2022年3月14日发布

  • Fixed a bug BadParcelableException：Parcelable 协议需要一个名为 CREATOR 的 Parcelable.Creator 对象.

Version 2.1.0

2022年2月24日发布

  • 令令牌获取更优化。
  • 当从 TokenUpdateListener.onTokenUpdated 调用时，YandexMetricaPush.getTokens 方法会返回新的令牌。
  • 库的性能和稳定性得到了提升。

Version 2.0.0

2021年10月28日发布

  • 修复了在 Android 12 中处理推送点击时偶尔出现的错误。
  • 从支持依赖切换到 AndroidX。

AppMetrica NDK 崩溃

要了解有关捕获本地崩溃的更多详情，请参见监控本地应用崩溃。

Version 3.1.0

Release 2025年7月30日

Version 3.0.0

Release 2023年9月13日

上一篇
Android
下一篇
过时版本 AppMetrica SDK 的重要更新