# Hotfix 项目地址

热更新能够不提交应用商店审核而修改 APP 内容,使得 app 的迭代变的非常灵活.

MogoH5+在1.3.0后加入了热更新/安装更新的集成.同时,我们的热更新服务器也在内测中,将在不久公测使用.您无需后端就可以完成整个软件的热更新/安装更新服务.

iphone 热更新 效果如下	安卓热更新效果如下	安卓安装更新如下

# 介绍

在使用热更新前,请看完这份介绍再使用.

# 热更新

对于安卓来说,热更新是没有任何问题的,但是苹果您可以看下面这段话.

# App store 应用更新说明(引自 dcloud)

应用资源更新肯定是违反 apple 政策的，但目前看起来它也不管。你在官网案例那里下载 Appstore 版本的那些 app，大多启动后都会提示更新，反正也都没下架。如果你不是很大的公司，apple 不会理睬你。如果你是大公司，建议不要做整体更新，每次更新几个页面，也不要提示更新后需要重启，这样会安全点。

作者本人的实践中也经常使用热更新,名声不大,不频繁基本上可以自由使用. 同样,我们加入了静默更新这种比较无脑的更新.

# 安装更新

安装更新在这里指的就是更新大版本,比如添加了模块,必须重新安装.

# 在安卓的安装更新

1. 可以让 APP 提示,然后用户选择自己下载安装
2. 应用商店更新

# 在苹果的安装更新

1. 必须提交 AppStore 提交审核

在这里顺便提一下,苹果用户的习惯一般是自己主动更新. 在苹果应用商店的大厂 app (微信,淘宝,京东) 更新几乎不会受到 app 的更新推送,也没有所谓检查更新的功能,也就是说,更新是用户主动操作的.我们的迭代同样也遵循这条行规.

# 引入方式

可以在main.js中添加checkUpdate(URL);,打开 app 就会自动检测.还可以放在检查更新的按钮上触发.

# ES6 Module 引入

首先在page.json把用到checkUpdate的页面加上管道|plusReady.

然后加载使用.

import { checkUpdate } from "./utils/hotfix";
checkUpdate(URL); // 填入您检查api的url地址

#<script>方式引入

这种用于没有使用脚手架的开发者

<title>APP</title>
<script src="html5plus://ready"></script>  // 这段必须加载title底下
....
<script src="path/hotfix-bs.js"></script>
<script>
  checkUpdate('https://api.hotfix.femirror.com/public/app/checkUpdate?bundleId=你的appId'); // 填入您检查api的url地址
</script>

# 热更新配置

热更新分为两种,在 ios 和安卓都可以使用:

1. 静默更新 : 使用checkUpdate方法后检查更新,如果有更新会自动下载 app,整个过程没有任何提示,用户第二次打开 app 就会出现更新后的效果.
2. 提示更新 : 使用checkUpdate方法后检查更新,如果有则会弹出确认框,用户确认后会提示正在下载,正在安装,安装完成重启,更新完成等提示.

如果您更新后不想立即重启,可以注释掉hotfix.js中的函数plus.runtime.restart();,这样,app 会在用户第二打开的时候自动完成更新.

# 后端接收的数据格式

checkUpdate(url) 是以 POST 去访问 URL 的.数据类型为application/json

# 后端返回的数据格式

下面是一个完整的数据返回 返回格式为application/json ,返回状态码为200.

注意 : 返回200以外的状态码将不被处理,如果想自行处理可以改写代码

下面这段json可以表达为:

1. 更新平台为 全部平台
2. 热更新
3. 提示更新

{
  "name": "2.2.1",
  "title": "发现新版本,快来使用吧!",
  "description": "1.增加了....\n 2.修复了... 3.杀了一个程序员祭天",
  "platform": "both",
  "type": "wgt",
  "hotupdate_type": "tip",
  "android_url": "http://cdn.femirror.com/H5FD926B1.wgt"
}