game_cocos_2c/extensions/hot-update-builder

热更新打包扩展

适用于 Cocos Creator 3.8.x 原生平台。扩展会在“构建发布”面板增加以下选项：

• 启用热更新
• 热更新 URL
• 热更新版本

开启后，每次原生构建完成会自动：

1. 向构建产物的 data/main.js 注入热更新搜索路径恢复及中断修复代码。
2. 扫描 src、assets、jsb-adapter 和 Creator 3.8 的 application.js，计算 MD5 和文件大小。
3. 将本地 project.manifest、version.manifest 写入构建产物的 data 根目录。
4. 在 <构建目录>/hot-update/<版本号> 生成可直接上传到热更新 URL 的远端完整资源包。

使用

1. 在 Creator 中打开“扩展 -> 扩展管理器 -> 项目”，刷新并启用“热更新打包”。
2. 重新打开或刷新“项目 -> 构建发布”。
3. 选择 Android/iOS 等原生平台，开启“启用热更新”，填写远端 URL 和版本。
4. 确保 Creator 的 MD5 Cache 选项关闭，然后执行构建。
5. 将构建日志显示的远端资源目录完整上传到配置的 URL。

例如配置 URL：

https://cdn.example.com/game/android/1.0.2/

则服务器上应可访问：

https://cdn.example.com/game/android/1.0.2/project.manifest
https://cdn.example.com/game/android/1.0.2/version.manifest
https://cdn.example.com/game/android/1.0.2/src/...
https://cdn.example.com/game/android/1.0.2/assets/...

注意

• 只支持原生平台，Web 构建不使用 native.AssetsManager。
• 构建扩展只负责生成热更新包；游戏运行时仍需用 native.AssetsManager 检查和下载更新。
• 更新成功后，运行时代码需将搜索路径保存到 HotUpdateSearchPaths 并调用 game.restart()。
• 升级 Creator 引擎版本或修改原生 C++/SDK 时应发布新的 APK/IPA，不应只做资源热更新。