更新

作者:Yuan Tang

更新于:5 个月前

字数统计:834 字

阅读时长:3 分钟

现有一个需求：客户想要点击 “检查更新” 按钮后判断当前是否是最新版本，不是最新版本则自动更新下载最新版本的 APP ，无需去到外部下载。

前置知识

plus 开头的方法是 APP 原生功能，是 5+Runtime 的内部对象，在普通浏览器运行plus api时控制台必然会输出 puls is not defined 错误提示。

详细的 runtime 方法与属性可查阅官方文档

runtime

https://www.html5plus.org/doc/zh_cn/runtime.html

tydumpling.cn

。

plus.runtime.getProperty

拿到的是当前应用的版本，如果热更新过就是热更新的版本。其接收两个参数：

参数一：应用的 Appid （必传）。
参数二：获得应用信息成功回调函数（必传）。

示例代码：

function getAppInfo() {
  plus.runtime.getProperty(plus.runtime.appid, (wgtinfo) => {
    // appid属性
    let wgtStr = `appid:${wgtinfo.appid}`
    // version属性
    wgtStr += `<br/>version:${wgtinfo.version}`
    // name属性
    wgtStr += `<br/>name:${wgtinfo.name}`
    // description属性
    wgtStr += `<br/>description:${wgtinfo.description}`
    // author属性
    wgtStr += `<br/>author:${wgtinfo.author}`
    // email属性
    wgtStr += `<br/>email:${wgtinfo.email}`
    // features 属性
    wgtStr += `<br/>features:${wgtinfo.features}`
    console.log(wgtStr)
  })
}

回调函数的参数中 version 属性是我们需要的版本号；name 属性是我们需要的应用名称。

注意：
plus.runtime.version 也能获取版本号，二者不同之处在于 plus.runtime.version 获取到的是 manifest.json 中设置的 apk/ipa 版本号，整包更新的版本。

install

安装应用的方法，其接收四个参数：

参数一：要安装的文件路径，支持应用资源安装包（wgt）、应用资源差量升级包（wgtu）、系统程序包（apk）（必传）。
参数二：应用安装设置的参数（选传）。
参数三：正确安装后的回调（选传）。
参数四：安装失败的回调（选传）。

plus.runtime.install(
  // 安装软件
  软件的下载地址, {
    force: true
  },
  // 成功回调
  (res) => {
    plus.runtime.restart()
  }
)

restart

重启当前的应用。

plus.runtime.restart()

应用热重启，重新启动进入首页。

quit

退出应用。

plus.runtime.quit()

实现思路

前端可以获取到当前用户的版本号信息，通过调用接口获取服务器最新的版本号信息
对比二者的版本号，如果当前版本低于最新版本，则根据后端返回的下载地址下载安装包
安装完后热重启应用

代码实现

// 检测版本更新
async function checkUpdates() {
  // #ifdef APP-PLUS
  // 调用接口获取后台版本信息，检查是否需要更新
  const versionInfo = await getAppInfo()
  console.log('获取后台版本信息', versionInfo)
  // 待更新版本
  const currentVersion = versionInfo.result.versionName
  console.log('后台需要更新版本', currentVersion)
  // 更新地址
  const androidUrl = 后端返回的地址

  //  比较版本是否不同 当前版本：plus.runtime.version
  const localVersion = version.value.split('.')
  const current = currentVersion.split('.')
  // 默认是同一个版本，不需要更新
  let flag = false
  current.forEach((item, i) => {
    if (Number.parseInt(item) > Number.parseInt(localVersion[i])) {
      // 检测到版本不同，需要更新
      flag = true
    }
  })

  if (flag) {
    uni.showModal({
      // 更新提醒
      title: '发现新版本，是否更新',
      content: `待更新版本号：${currentVersion}`,
      // showCancel: showCancel,
      success: (res) => {
        if (res.confirm) {
          doUpData(androidUrl)
        }
        else if (res.cancel) {
          // 不更新强制退出app
          // if (showCancel) {
          // 	console.log('不更新强制退出app');
          // 	plus.runtime.quit();
          // }
        }
      }
    })
  }
  else {
    uni.showToast({
      title: '当前已是最新版本',
      icon: 'none'
    })
  }
  // #endif
}
function doUpData(Url) {
  uni.showLoading({
    title: '更新中……'
  })
  const downloadTask = uni.downloadFile({
    // 执行下载
    url: Url, // 下载地址
    timeout: 1000 * 30, // 30秒超时时间
    success: (downloadResult) => {
      // 下载成功
      console.log(downloadResult)
      uni.hideLoading()
      if (downloadResult.statusCode == 200) {
        plus.runtime.install(
          // 安装软件
          downloadResult.tempFilePath, {
            force: true
          },
          (res) => {
            plus.runtime.restart()
          }
        )
      }
    },
    complete: (com) => {
      uni.hideLoading()
    }
  })
}

Contributors

Yuan Tang

更新 ​

前置知识 ​

plus.runtime.getProperty ​

install ​

restart ​

quit ​

实现思路 ​

代码实现 ​

Contributors ​

更新