跳到主要内容

APP热更新打包

什么是热更新​

热更新是一种无需重新下载安装APP（即不重新打包APK/IPA文件），即可实现APP功能更新和bug修复的技术方案。通过热更新，用户可以在保持APP安装状态不变的情况下，获得最新的功能和修复内容。

准备工作​

在进行热更新打包前，请确保：

  1. 已安装HBuilderX开发工具
  2. 已配置好APP开发环境
  3. 已部署JeecgBoot3后端项目
  4. 已完成APP的基础开发和测试工作

热更新打包流程​

1. 修改应用版本号​

首先需要修改项目根目录下的 manifest.config.ts 文件中的应用版本号：

版本号规则说明：热更新仅支持同一主版本号下的小版本升级（仅修改版本号的最后一位）。例如，可以将 1.0.8 升级到 1.0.9，但不能直接从 1.0.8 升级到 1.1.0。

2. 打包WGT文件​

WGT文件是用于热更新的资源包，包含了APP的更新内容。

在HBuilderX开发工具中执行以下操作：

  1. 点击顶部菜单栏的 发行 按钮
  2. 选择 app-制作应用wgt 选项：

  1. 在弹出的窗口中选择对应的打包平台：

  1. 等待打包完成，出现以下提示则表示WGT文件打包成功：

打包成功提示

3. 配置热更新接口​

在项目中找到 appUpdate 文件，修改热更新接口地址：

修改热更新接口

将图中的接口地址修改为您服务器上WGT文件的下载接口地址。

4. 更新版本管理信息​

在JeecgBoot3项目管理后台中执行以下操作：

  1. 找到并进入 APP版本管理 菜单：

APP版本管理菜单

  1. 点击对应应用的编辑按钮，修改热更新文件信息：

修改热更新文件信息

  1. 填写WGT文件的下载地址、版本号等信息，保存配置。

5. 验证热更新效果​

打开手机APP，系统会自动检查是否有新的热更新版本。如果检测到新版本，APP会自动开始下载并安装更新：

热更新效果

注意事项​

  1. 版本号一致性：热更新WGT文件的版本号必须与APP当前安装的版本号兼容（仅最后一位不同）
  2. 版本号规则：
    • 仅修改版本号最后一位时（如1.0.8 → 1.0.9），可通过热更新实现
    • 修改版本号前两位时（如1.0.8 → 1.1.0或2.0.0），需要重新打包完整的APP安装包（APK/IPA）
  3. 自定义热更新逻辑：appUpdate 文件中的热更新逻辑可以根据实际需求进行自定义修改
  4. 服务器配置：确保WGT文件所在的服务器支持跨域访问，并且下载速度稳定