# 发版记录

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



| 版本号    | 发布日期       | 备注                                                 |
| ------ | ---------- | -------------------------------------------------- |
| 5.0.27 | 2026-09-10 | idfa获取权限请求冲突优化；限制 $AdShow 的 $ad\_type 取值           |
| 5.0.26 | 2026-08-05 | 兼容引擎老版本设置caid信息                                    |
| 5.0.25 | 2026-07-28 | 支持预设公共属性和归因信息，移除老版 initialize 接口（含 caid1/caid2 参数） |
| 5.0.24 | 2026-05-28 | 支持更新用户信息                                           |
| 5.0.23 | 2026-04-16 | 优化初始化信息获取                                          |
| 5.0.22 | 2026-03-05 | 国内海外域名区分；演练模式接口优化;支持Mac平台                          |
| 5.0.20 | 2026-02-09 | 新增获取设备信息方法;支持h5打通                                  |
| 5.0.19 | 2026-01-29 | 接入优化                                               |
| 5.0.18 | 2026-01-20 | bug修复                                              |
| 5.0.17 | 2026-01-09 | caid传参优化                                           |
| 5.0.16 | 2025-12-17 | 支持设置前台会话阀值,优化AppEnd时间统计                            |
| 5.0.15 | 2025-12-09 | 优化idfa获取逻辑                                         |
| 5.0.14 | 2025-12-09 | 支持演练模式                                             |
| 5.0.13 | 2025-12-02 | 百度paid归因支持;海外隐私政策适配                                |
| 5.0.12 | 2025-11-20 | 性能优化                                               |
| 5.0.11 | 2025-11-11 | SDK 内部解决网络冲突                                       |
| 5.0.10 | 2025-11-04 | 性能优化                                               |
| 5.0.9  | 2025-10-24 | 优化了 att 弹窗的超时处理逻辑                                  |
| 5.0.8  | 2025-09-29 | 加密传输                                               |
| 5.0.6  | 2025-09-04 | 性能优化                                               |
| 5.0.3  | 2025-05-24 | 支持初始化时手动传入 clientID                                |
| 5.0.2  | 2025-04-23 | 性能优化                                               |
| 4.8.11 | 2025-04-07 | 报错 catch                                           |
| 4.8.10 | 2025-03-14 | 性能优化                                               |
| 4.8.9  | 2025-02-28 | 避免客户误用 login 方法                                    |
| 4.8.6  | 2024-08-28 | 性能优化                                               |
| 4.8.5  | 2024-08-12 | 支持客户传入 channel，支持越狱渠道排除                            |
| 4.8.4  | 2024-08-08 | 支持融合归因                                             |
| 4.8.3  | 2024-04-25 | 提供简化版 initialize 方法                                |
| 4.7.3  | 2024-02-20 | 性能优化                                               |
| 4.7.2  | 2023-12-11 | 接入流程优化，不再自动采集$AppRegister 事件                       |
| 4.6.3  | 2023-11-28 | 支持补报设备 ID 信息                                       |
| 4.6.2  | 2023-11-09 | 支持历史用户注册                                           |
| 4.6.1  | 2023-10-10 | 性能优化                                               |
| 4.5.5  | 2023-09-20 | 支持同步获取归因结果信息                                       |
| 4.5.2  | 2023-09-14 | 支持获取当前 ClientID                                    |
| 4.5.1  | 2023-08-30 | 支持查询用户信息接口                                         |
| 4.3.2  | 2023-07-14 | ASA 归因信息自动采集                                       |
| 4.3.1  | 2023-07-13 | 支持重置 Client ID；支持打通三方数据平台                          |
| 4.2.9  | 2023-07-05 | 支持 Unity 打通                                        |
| 4.2.8  | 2023-06-29 | 性能优化                                               |
| 4.2.7  | 2023-06-23 | 支持自动采集用户注册事件                                       |
| 4.2.6  | 2023-06-07 | 修复用户使用时长统计问题                                       |
| 4.2.5  | 2023-06-02 | 性能优化                                               |
| 4.2.4  | 2023-05-31 | 支持 ASA 归因                                          |
| 4.2.3  | 2023-05-28 | 优化初始化、注册、登录、退出登录流程;优化归因参数采集逻辑                      |
| 4.2.1  | 2023-05-22 | 初始版本上线                                             |