uni-app-upgrade

APP热更，整包一体 升级模板使用说明

简介说明:


开箱即用。简单部署，下载运行即可看到效果，完全不需要后台！！！ 在每个栏目下都有一个 update.json 文件，此文件作为升级功能的重要文件，需要把这个文件放在服务器下，通过请求此文件完成校验并升级。此文件在测试demo中默认是放置启动页面，每次启动应用检测到升级包必回强制升级。如需改动请开发者自行调整。


重要文件说明：

1.update.vue 本机核心文件，包含所有升级程序。升级完成后会自动跳转到登陆页面，可以自行修改。1.update.json 服务器核心文件， 包含所有的升级信息。把此文件去注释扔到服务器上即可。1.base.js 包含了update.json的升级地址，记得到时候改成自己的服务器地址

使用说明：

  • 卸载app上已经存在的hbuilder或hbuilderx同步的app，方便测试。
  • 下载打开uni-app-upgrade文件夹，点击去找到update.json 文件，扔到服务器。
  • 找到对应项目下的base.js，修改路径为你自己的update.json文件路径。
  • 查看对应项目下的manifest.json 节点版本号，修改update.json下version节点。列如：manifest.json下为1.0.0，update.json修改version为1.0.1 则升级，节点属性相同则不升级App直接跳过升级操作。

注意事项：

  • update.json 必须是严格的json，去掉所有注释
  • update.json 下size节点必须是字节并且是热更包的文件大小，此参数只会在热更模式下起效，整包更新忽略。
  • 同version节点，热更包必须必比用户手机上的的要高。也就是说服务器上的update.json，version节点必须和更新包version一样 且必须大于用户本机应用。
  • 把manifest.json下splashscreen—>alwaysShowBeforeRender 改为false,waiting改为false,autoclose改为false
  • 进度条使用的是uni-app自带的，他的进度条有点小问题。实际内容以及加载到100%了，动画却半天才到，可以随便找个ui库替换进度条即可

update.json

节点名称参数类型必填描述
versionstring是用于对比manifest.json中的版本号
downloadstring是必填 热更下载地址 string格式只能唯一
new_downloadArray否非必填 Array格式 循环下载，挨着尝试（直到成功结束），尝试完成。当前此项存在的时候忽略download 属性
sizenumber是当前安装包文件大小(b)，用于对比当前下载的包是否完整
android—>min_hotupdate_verstring是最小支持的热更版本，如果此选项和version选项相同值的情况下，会采取浏览器打开的方式下载。整包更新。
android—>installstring是整包下载地址 string格式只能唯一
android—>new_installArray否Array格式 随机选择一个下载地址打开浏览器下载。当前此项存在的时候忽略install 属性
iphone—>min_hotupdate_verstring是最小支持的热更版本，如果此选项和version选项相同值的情况下，会采取浏览器打开的方式下载。整包更新。
iphone—>installstring是整包下载地址 string格式只能唯一
iphone—>new_installArray否Array格式 随机选择一个下载地址打开浏览器下载。当前此项存在的时候忽略install 属性

以上升级程序必须是update.json中的version选项版本号大于manifest.json中versionName选项才会执行升级，否则不会执行升级直接略过。


更新日志：

1. 2019年3月20日19:30:28 首次提交
2. 2019年3月22日19:02:00 更新文档注意事项
3. 2019年3月27日16:37:41 修复使用热更后无法使用整包更新的问题

相关连接

1. mui、5+ App升级程序 文档同上