# 热更新打包扩展

适用于 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：

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

则服务器上应可访问：

```text
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，不应只做资源热更新。