uniapp的更新流程【安卓、IOS、热更新】

发布于:2025-06-21 ⋅ 阅读:(16) ⋅ 点赞:(0)

UniApp应用更新方案

两种更新方式

  1. APP全量升级:需要重新下载安装包
  2. 热更新:通过下载wgt资源包实现,用户只需重启应用

Android更新实现

用户需要授权安装权限,流程为下载APK后自动弹出安装界面

var dtask = plus.downloader.createDownload("APK下载地址", {
  method: "GET"
}, (d, status) => {
  if (status == 200) {
    console.log("下载成功安装: " + d.filename);
    plus.runtime.install(d.filename)
  } else {
    plus.nativeUI.alert("安装失败,请稍候重试: " + status)
  }
});

this.downloading = true
dtask.addEventListener('statechanged', (e) => {
  // 下载进度监听
  this.downloadedSize = (e.downloadedSize / 1000000).toFixed(1)
  this.packageFileSize = (e.totalSize / 1000000).toFixed(1)
  this.downLoadPercent = (e.downloadedSize / e.totalSize * 100).toFixed(0)
});
dtask.start();

iOS更新实现

直接跳转至App Store

plus.runtime.openURL("appStore地址");

热更新实现步骤

  1. 修改版本号
    更新manifest.json中的版本号(如从1.0.0升级到1.0.1或1.1.0)

    版本号修改示例

  2. 生成升级包
    在HBuilderX中:菜单->发行->原生App-制作移动App资源升级包(wgt)

    制作升级包

  3. 部署更新
    将wgt包上传至服务器,在代码中实现版本检测和更新逻辑

uni.downloadFile({
  url: "wgt地址",
  success: (downloadResult) => {
    uni.showLoading({
      title: '更新中'
    })
    if (downloadResult.statusCode === 200) {
      uni.hideLoading();
      
      plus.runtime.install(downloadResult.tempFilePath, {
        force: true  // 是否强制更新
      }, function() {
        console.log('install success...');
        setTimeout(() => {
          plus.runtime.restart();
        }, 0)
      }, function(e) {
        console.error(e);
      });
    } else {
      console.error('download fail...');
    }
  }
});

注意事项

  1. 开发阶段使用HBuilder应用信息,需打包自定义基座或正式包测试
  2. 使用plus.runtime.getProperty()获取manifest版本信息而非plus.runtime.version
  3. 安装wgt包后必须调用plus.runtime.restart()使更新生效
  4. 使用条件编译限定仅在App平台执行更新逻辑

网站公告

今日签到

点亮在社区的每一天
去签到