uni-app-upgrade

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

简介说明:

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

重要文件说明:

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

使用说明:

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

注意事项:

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

update.json

节点名称 参数类型 必填 描述
version string 用于对比manifest.json中的版本号
download string 必填 热更下载地址 string格式只能唯一
new_download Array 非必填 Array格式 循环下载,挨着尝试(直到成功结束),尝试完成。当前此项存在的时候忽略download 属性
size number 当前安装包文件大小(b),用于对比当前下载的包是否完整
android-->min_hotupdate_ver string 最小支持的热更版本,如果此选项和version选项相同值的情况下,会采取浏览器打开的方式下载。整包更新。
android-->install string 整包下载地址 string格式只能唯一
android-->new_install Array Array格式 随机选择一个下载地址打开浏览器下载。当前此项存在的时候忽略install 属性
iphone-->min_hotupdate_ver string 最小支持的热更版本,如果此选项和version选项相同值的情况下,会采取浏览器打开的方式下载。整包更新。
iphone-->install string 整包下载地址 string格式只能唯一
iphone-->new_install Array 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升级程序 文档同上

powered by Gitbook该文件修订时间: 2020-04-06 12:49:50

results matching ""

    No results matching ""