AI-ready documentation
发版记录
记录 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 依赖，优化事件采集性能。 |