# 发版记录

> 来源：https://help.gravity-engine.com/docs/client-sdk/android/changelog
> 记录 Gravity Engine Android SDK 各版本的发布日期、功能变更和升级备注，便于核对版本能力。



| 版本号    | 发布日期       | 备注                                       |
| ------ | ---------- | ---------------------------------------- |
| 5.0.34 | 2026-09-10 | 限制 $AdShow 的 $ad\_type 取值                |
| 5.0.33 | 2026-07-28 | 支持预设公共属性和归因信息，设备信息获取优化                   |
| 5.0.32 | 2026-06-23 | 设备敏感信息获取限频                               |
| 5.0.31 | 2026-06-03 | 接口请求移除敏感信息                               |
| 5.0.30 | 2026-05-28 | 支持用户基础信息更新；支持获取华为归因                      |
| 5.0.29 | 2026-04-16 | 优化初始化信息获取                                |
| 5.0.28 | 2026-03-05 | 国内海外域名区分；演练模式接口优化                        |
| 5.0.27 | 2026-02-09 | 新增获取设备信息方法；支持h5打通                        |
| 5.0.26 | 2026-01-29 | 接入优化                                     |
| 5.0.25 | 2026-01-20 | 降低Android ID获取频率                         |
| 5.0.24 | 2026-01-09 | 网络请求优化                                   |
| 5.0.23 | 2025-12-17 | 支持设置前台会话阀值,优化AppEnd时间统计                  |
| 5.0.22 | 2025-12-12 | 支持设置 ClientId 取值顺序                       |
| 5.0.21 | 2025-12-02 | SDK海外适配                                  |
| 5.0.20 | 2025-11-20 | 演练模式支持返回原因                               |
| 5.0.19 | 2025-11-04 | 性能优化                                     |
| 5.0.18 | 2025-10-31 | 优化 flush 时机，性能优化提升，建议升级！                 |
| 5.0.17 | 2025-10-24 | 更改接入方式，优化客户接入体验                          |
| 5.0.16 | 2025-10-22 | 支持 enableMac 动态启停 Mac 采集                 |
| 5.0.15 | 2025-10-13 | 接入优化                                     |
| 5.0.12 | 2025-09-19 | 修复华为设备未正确添加依赖时闪退的问题                      |
| 5.0.8  | 2025-09-06 | 支持百度 bd\_vid 注入方案                        |
| 5.0.7  | 2025-09-05 | 优化自动采集开启逻辑                               |
| 5.0.6  | 2025-08-30 | 提供接入最佳实践，支持自动采集 ClientID                 |
| 5.0.3  | 2025-06-11 | 继续采集 $device\_id                         |
| 5.0.2  | 2025-04-25 | 优化设备 Id 采集                               |
| 5.0.1  | 2025-04-23 | 性能优化                                     |
| 4.8.26 | 2025-04-21 | 优化信息采集                                   |
| 4.8.25 | 2025-03-25 | 优化设备 ID 上报时机                             |
| 4.8.24 | 2025-02-28 | 优化 AndroidID 获取逻辑；避免客户误用 login、logout 方法 |
| 4.8.19 | 2024-11-30 | 进一步优化演练模式接入流程，降低接入门槛                     |
| 4.8.15 | 2024-11-28 | 优化演练模式                                   |
| 4.8.12 | 2024-11-12 | Unity 支持演练模式                             |
| 4.8.11 | 2024-09-26 | 优化性能                                     |
| 4.8.10 | 2024-08-28 | 优化性能                                     |
| 4.8.9  | 2024-08-01 | 适配高版本                                    |
| 4.8.6  | 2024-05-05 | 支持传入 mas 秘钥字符串；支持获取预置属性信息                |
| 4.8.4  | 2024-04-22 | 支持立即上报设备信息，优化设备信息采集成功率                   |
| 4.8.3  | 2024-04-15 | bug fix                                  |
| 4.7.8  | 2024-03-03 | 优化设备信息绑定逻辑                               |
| 4.7.5  | 2024-01-22 | 优化性能问题                                   |
| 4.7.4  | 2023-12-26 | 放开可见性问题                                  |
| 4.7.3  | 2023-12-26 | 支持历史用户初始化                                |
| 4.7.2  | 2023-12-11 | 接入流程优化，不再自动采集$AppRegister 事件             |
| 4.6.3  | 2023-11-23 | 优化 ID 获取逻辑                               |
| 4.6.2  | 2023-11-06 | 优化 ID 获取逻辑                               |
| 4.5.7  | 2023-10-20 | 注册接口支持返回注册的结构体信息；修复混淆问题                  |
| 4.5.5  | 2023-09-20 | 支持同步获取归因结果信息                             |
| 4.5.3  | 2023-08-30 | 支持查询用户信息接口                               |
| 4.3.2  | 2023-07-14 | 性能优化                                     |
| 4.3.1  | 2023-07-13 | 支持重置 Client ID；支持打通三方数据平台                |
| 4.2.8  | 2023-06-29 | 性能优化                                     |
| 4.2.7  | 2023-06-23 | 性能优化                                     |
| 4.2.6  | 2023-06-16 | 支持 Unity 原生 Android 项目打通                 |
| 4.2.5  | 2023-06-14 | 性能优化                                     |
| 4.2.4  | 2023-06-12 | 优化唯一 ID 逻辑，开放获取                          |
| 4.2.3  | 2023-05-25 | 修复线上可能的崩溃，优化性能                           |
| 4.2.2  | 2023-05-20 | 自动采集是否首次付费字段                             |
| 4.2.1  | 2023-04-19 | 性能优化                                     |
| 4.2.0  | 2023-04-17 | 优化 login 方法                              |
| 4.1.8  | 2023-04-03 | 1. 自动采集注册事件；2. 广告观看事件立即上报，避免数据 gap       |
| 4.1.6  | 2023-03-20 | 支持自动标记是否首次付费属性                           |
| 4.1.5  | 2023-03-16 | 支持全埋点自采集方案                               |
| 4.1.3  | 2023-03-14 | 重构上线，解除 okhttp 和 androidx 依赖，优化事件采集性能。   |