当前位置：首页 > uni-app

uniapp下发更新

2026-03-05 04:38:53uni-app

uniapp 下发更新方法

热更新（wgt 包更新） 热更新适用于不涉及原生代码修改的更新，通过生成 wgt 包实现用户无感更新。开发者需在 uni-admin 后台配置更新信息，客户端通过 uni.getUpdateManager() 检测并下载更新包。

整包更新（apk/ipa 包更新） 整包更新适用于涉及原生代码修改或重大版本升级。开发者需将新包上传至应用商店或自有服务器，客户端通过版本号比对提示用户下载安装。

静默更新 静默更新在用户无感知情况下完成，通常用于紧急修复或小范围更新。需结合服务端版本控制和客户端定时检查机制实现。

灰度发布 通过控制更新包的分发范围，逐步验证新版本稳定性。可在 uni-admin 后台设置特定用户群体或百分比进行灰度发布。

强制更新 对于涉及重大安全或功能问题的更新，可在客户端添加强制更新逻辑。当检测到新版本时，阻止用户继续使用旧版本直至完成更新。

实现代码示例

客户端检测更新逻辑

const updateManager = uni.getUpdateManager();
updateManager.onCheckForUpdate(function(res) {
  if (res.hasUpdate) {
    updateManager.onUpdateReady(function() {
      uni.showModal({
        title: '更新提示',
        content: '新版本已准备好，是否重启应用？',
        success(res) {
          if (res.confirm) {
            updateManager.applyUpdate();
          }
        }
      });
    });
  }
});

服务端版本控制接口 建议维护版本信息 API 返回如下数据结构：

uniapp下发更新

{
  "latest_version": "1.2.0",
  "min_support_version": "1.1.5",
  "update_url": "https://example.com/app.apk",
  "is_force_update": false,
  "update_content": "修复已知问题"
}