# 发版记录

> 来源：https://help.gravity-engine.com/docs/client-sdk/cocos-creator/changelog
> 记录 Gravity Engine CocosCreator SDK 各版本的发布日期、功能变更和升级备注，便于核对版本能力。
> 文档修改日期：2026-11-18




| 版本号    | 发布日期       | 备注                                                                                                              |
| ------ | ---------- | --------------------------------------------------------------------------------------------------------------- |
| 6.0.19 | 2026-11-18 | 数据上报策略优化                                                                                                        |
| 6.0.18 | 2026-11-03 | 支持初始化预设用户属性                                                                                                     |
| 6.0.17 | 2026-10-19 | 支持 TikTok 获取 openid                                                                                             |
| 6.0.16 | 2026-10-16 | B 站网络状态获取 debug 兼容                                                                                              |
| 6.0.15 | 2026-10-10 | 支持支付宝获取 openid                                                                                                  |
| 6.0.14 | 2026-09-18 | 数据上报优化                                                                                                          |
| 6.0.13 | 2026-09-10 | 支持芒果 TV 小游戏；腾讯 SDK 更新至 1.5.11；支持无 dn 版本 SDK                                                                     |
| 6.0.12 | 2026-08-06 | initialize 获取启动参数优化                                                                                             |
| 6.0.11 | 2026-07-28 | 支持预设公共属性；支持预设归因信息；再归因窗口期默认 30 天                                                                                 |
| 6.0.10 | 2026-06-24 | 修复了一些问题                                                                                                         |
| 6.0.9  | 2026-05-28 | 支持更改用户基础信息                                                                                                      |
| 6.0.8  | 2026-05-14 | 支持微信小游戏直玩状态判断；Cocos 快应用联盟 vivo 打包适配；支持闲鱼小游戏                                                                     |
| 6.0.6  | 2026-04-30 | 腾讯 IAA 支持上报更多必要事件                                                                                               |
| 6.0.5  | 2026-03-16 | 腾讯 SDK 更新至 1.5.7；其他优化                                                                                           |
| 6.0.4  | 2026-03-05 | 新增 TapTap 小游戏支持                                                                                                 |
| 6.0.3  | 2026-02-11 | Laya 引擎 Native 判断容错；支持小程序页面浏览统计；其他优化                                                                            |
| 6.0.2  | 2026-01-29 | 支持设置 openId 前进行数据缓存                                                                                             |
| 6.0.1  | 2026-01-29 | Cocos 支持 iOS、Android、鸿蒙底层；Laya、Egret 支持 iOS、Android 底层；新增 nativeAdShowEvent、miniGameAdShowEvent；ad\_params 获取优化 |
| 6.0.0  | 2026-01-07 | 支持数据本地化存储与批量上传；新增 flush 接口                                                                                      |
| 5.0.14 | 2025-12-05 | 修复了一些问题                                                                                                         |
| 5.0.13 | 2025-12-05 | 支持统计腾讯 SDK track 事件报错；腾讯 SDK 更新至 1.5.6；支持腾讯 SDK on\_report\_complete 回调                                         |
| 5.0.12 | 2025-11-04 | 修复了一些问题                                                                                                         |
| 5.0.11 | 2025-09-26 | 新增 getCurrentClientId 方法；config.tencentSdkData 新增 onReportFail 回调                                               |
| 5.0.10 | 2025-09-01 | 快应用启动时支持传入自定义参数 gravityQuery                                                                                    |
| 5.0.8  | 2025-08-13 | 创角事件上报支持额外参数                                                                                                    |
| 5.0.7  | 2025-08-12 | 修复 iOS 回传校准失败的问题                                                                                                |
| 5.0.6  | 2025-08-08 | 支持微信小游戏 iOS 回传付费校准；支持快应用初始化时手动传入启动参数                                                                            |
| 5.0.4  | 2025-06-11 | 修复了一些问题                                                                                                         |
| 5.0.3  | 2025-04-28 | 修复了一些问题                                                                                                         |
| 5.0.2  | 2025-04-24 | 修复了一些问题                                                                                                         |
| 5.0.1  | 2025-04-23 | 性能优化                                                                                                            |
| 4.8.54 | 2025-04-09 | 修复华为快游戏启动参数获取失败的问题                                                                                              |
| 4.8.52 | 2025-03-18 | 支持荣耀小游戏                                                                                                         |
| 4.8.51 | 2025-03-12 | 优化缓存的逻辑                                                                                                         |
| 4.8.50 | 2025-03-06 | 支持传入额外参数到引力                                                                                                     |
| 4.8.49 | 2025-03-03 | 修复 wechat adn\_type 获取的 bug，关注微信小游戏广告收入的客户建议升级                                                                  |
| 4.8.48 | 2025-02-19 | 性能优化                                                                                                            |
| 4.8.47 | 2025-01-17 | 华为快游戏支持上报广告事件                                                                                                   |
| 4.8.44 | 2024-12-27 | 支持获取 B 站小游戏 openid                                                                                              |
| 4.8.43 | 2024-12-25 | 支持 preInit 缓存；支持 enableDryRun 控制演练模式；支持自定义注册事件使用演练模式回传                                                          |
| 4.8.41 | 2024-12-19 | 腾讯 SDK 默认开启自动采集，不再手动调用 onAppStart                                                                               |
| 4.8.40 | 2024-12-12 | 修复演练模式下回传腾讯漏报的问题                                                                                                |
| 4.8.39 | 2024-12-12 | 优化 openid 设置逻辑，修复腾讯 setOpenId 错误                                                                                |
| 4.8.36 | 2024-12-11 | 演练模式接口优化                                                                                                        |
| 4.8.35 | 2024-12-11 | 代码优化                                                                                                            |
| 4.8.33 | 2024-12-06 | 适配最新腾讯小游戏 SDK；修复重要 bug；完整兼容演练模式                                                                                 |
| 4.8.32 | 2024-12-04 | 修复腾讯小游戏 SDK 重要 bug；优化演练模式查询逻辑；修复支付宝小游戏 Debug 模式无法开启                                                             |
| 4.8.31 | 2024-11-29 | 修复重要问题；支持微信小游戏演练模式                                                                                              |
| 4.8.30 | 2024-11-28 | 修复重要问题，使用腾讯小游戏 SDK 回传的客户建议升级                                                                                    |
| 4.8.28 | 2024-11-26 | 修复一些问题                                                                                                          |
| 4.8.26 | 2024-11-25 | 正式接入腾讯小游戏 SDK                                                                                                   |
| 4.8.21 | 2024-10-11 | 接入优化                                                                                                            |
| 4.8.20 | 2024-10-08 | 优化接入体验                                                                                                          |
| 4.8.19 | 2024-09-12 | 快应用、快游戏支持同步采集设备 ID                                                                                              |
| 4.8.18 | 2024-09-12 | OPPO 快游戏启动参数获取优化                                                                                                |
| 4.8.15 | 2024-08-21 | 修复快应用自动采集启动事件的 bug；修复 vivo 快游戏采集启动参数 bug；优化华为快应用采集 oaid 逻辑                                                      |
| 4.8.10 | 2024-06-19 | 支付宝小游戏自动采集 channel 参数，支持灯火平台买量                                                                                  |
| 4.8.8  | 2024-06-12 | 支付宝小游戏广告上报优化                                                                                                    |
| 4.8.4  | 2024-06-03 | 增加异常捕获；修复 H5 类型产品采集 bug                                                                                         |
| 4.8.3  | 2024-04-25 | 修复 bug；优化 Laya2 支持                                                                                              |
| 4.8.1  | 2024-02-23 | 支持 Taro；修复 Egret 平台绑定三方平台的 bug                                                                                  |
| 4.7.21 | 2024-02-07 | 修复快游戏 OPPO 设备 ID 采集问题                                                                                           |
| 4.7.13 | 2024-02-02 | 支持 OPPO 快游戏买量                                                                                                   |
| 4.7.11 | 2024-01-19 | 修复快游戏启动事件采集问题                                                                                                   |
| 4.7.10 | 2024-01-15 | 修复快游戏参数解析问题                                                                                                     |
| 4.7.9  | 2024-01-08 | 修复快手小游戏场景值获取 bug                                                                                                |
| 4.7.6  | 2023-12-29 | 修复华为快应用参数解析问题；优化初始化逻辑                                                                                           |
| 4.7.5  | 2023-12-22 | 支持快手小游戏、小程序                                                                                                     |
| 4.7.3  | 2023-12-11 | 优化接入流程；不再自动采集 MPRegister 事件                                                                                     |
| 4.6.5  | 2023-11-25 | H5 产品支持更多买量平台                                                                                                   |
| 4.6.2  | 2023-10-12 | 支持接口上报历史用户注册                                                                                                    |
| 4.6.1  | 2023-10-08 | 上报首次启动场景；抖音广告获取逻辑优化                                                                                             |
| 3.5.6  | 2023-09-20 | 优化抖音广告 ecpm 获取逻辑；优化小程序启动事件上报逻辑                                                                                  |
| 3.5.4  | 2023-08-30 | 支持获取用户信息；支持添加自定义参数上报到广告观看事件                                                                                     |
| 3.5.2  | 2023-08-23 | 支持抖音小程序；支持 uni-app；广告观看事件支持自定义参数                                                                                |
| 3.4.7  | 2023-06-25 | 修复抖音小游戏启动事件上报的 bug                                                                                              |
| 3.4.6  | 2023-06-21 | 支持抖音小游戏广告统计；优化接入流程                                                                                              |
| 3.4.5  | 2023-06-16 | 支持抖音小游戏；性能与接入流程优化                                                                                               |
| 3.4.3  | 2023-05-25 | 自采集渠道信息到用户属性；性能优化                                                                                               |
| 3.4.2  | 2023-05-16 | 后端自动判断首付；上报全量 query 数据                                                                                          |
| 3.3.14 | 2023-04-20 | 用户注册成功后自动采集关键信息上报                                                                                               |
| 3.3.13 | 2023-03-29 | 注册流程优化；自采集注册事件                                                                                                  |
| 3.3.12 | 2023-03-15 | debugMode 开启优化；channel 由 SDK 自采集                                                                                |
| 3.3.9  | 2023-03-06 | 用户属性支持 min/max 操作；支持引力换量；数据校验 bug 修复                                                                            |
| 3.3.7  | 2023-02-16 | 广告观看事件上报；付费事件上报                                                                                                 |
| 3.3.6  | 2023-02-14 | 修复启动事件上报 bug                                                                                                    |
| 3.3.5  | 2023-02-10 | 支持百度归因；优化初始化逻辑；支持 Egret Demo                                                                                    |
| 3.2.8  | 2023-02-08 | 内部优化                                                                                                            |
