cordova热更新 + 亲测有用 + 踩坑排雷拍小白

原文章链接
作者 泛舟江湖
https://www.cnblogs.com/changzz/p/10763986.html

又找到的一个感觉不错，可以让用户决定是否进行安装，而且也较为详细
https://www.jianshu.com/p/cb45fbc93a8b

以下是做的一些补充加说明

cordova热更新
探索cordova项目前段时间增加了热更新功能，自己第一次做的时候在网上查找了很多资料，有的资料写的并不全面遇到了很多坑。因此总结一些在开发过程中遇到了问题和解决办法。

这里不涉及app版本更新，只是热更新。

web代码的更新
此更新方式，只需要更新web前段代码，不需要更新android的原生代码。只是对js、html等的更新。

1、添加插件 Cordova Hot Code Push

cordova plugin add cordova-hot-code-push-plugin 

2、添加热更新工具 cordova-hot-code-push-cli

npm install -g cordova-hot-code-push-cli

3、添加cordova-hcp.json文件（按照下面代码操作自动生成）

此文件是用于方便生成www文件下chcp.json文件的内容。

执行命令（必须在项目根目录执行更新工具的命令）

cordova-hcp init 生成热更新相关配置文件
生成的默认应用程序配置文件(cordova-hcp.json)在项目根文件夹中。

执行时将要求您从命令行中填写一些项目首选项：
Project name: 你现在的项目名称所需.
Amazon S3 Bucket name:亚马逊上的S3桶的名字。可以跳过。
Amazon S3 region: 亚马逊S3地区。可以跳过。
iOS app identifier: 应用程序商店的应用程序ID。App升级是跳转应用商店进行升级。
Android app identifier: 可以App在应用商城的地址，或者是apk的下载地址。

Update method: 何时执行更新。

start: 在启动应用程序时安装更新。

resume: 在恢复应用程序(从背景移动到前景状态)或启动时，安装更新；默认使用。

now: 从服务器加载更新后立即安装。

Enter full URL to directory where cordova-hcp build result will be uploaded:服务器 www 文件的地址（例子：http://123.12.72.21:8292/ougg/www/）

ps:我为了确认地址的可查看性，在里面放了一张图片，用这个链接加图片名字可以直接用外网在浏览器上读得到

cordova-hcp.json文件内容：

{
“name”: “”,//可为空
“autogenerated”: true,//如果不添加，热更新会不能使用
“ios_identifier”: “id123456789”,//应用在App store id(可为空)
“android_identifier”: “”,//应用在应用商城上的地址或者App的下载地址(可为空)
“update”: “start”,//在应用启动时安装
“min_native_interface”: 1,//可用以做App升级（可以不填)
“content_url”:
“http://************/cordova/www”//www文件在服务器上的地址
}
“autogenerated”: true 这个值执行命令后是没有的需要自己手动添加，如果不添加网页内容更新将会无效。（我试了一下不用好像也行）

4、在www文件下生成chcp.json 和 chcp.manifest文件（按照下面代码操作自动生成）

chcp.json: 包含发布相关信息：热更新代码版本号，应用 native side 版本号等等

chcp.manifest: 包含项目热更新代码(静态)文件信息：文件名和文件哈希值

执行命令
cordova-hcp build执行此命令会在chcp.json文件中增加"release":"当前时间"字段。（默认使用时间戳，格式为：yyyy.MM.dd-HH.mm.ss），插件将版本号进行字符串相等比较来判断是否存在新版本。

“release”: “2017.06.07-16.30.20”,//唯一web项目版本号,用与热更新web内容的更新。（必需，不用管）

5、config.xml 配置

最好写在底部方便以后配置修改（放到widget标签里面即可）

	<chcp>
	    <auto-download enabled="true" />
	    <auto-install enabled="true" />
	    <native-interface version="1" />
	    <config-file url="https://************/cordova/www/chcp.json" />
	</chcp>
</widget>

config-file：配置文件 chcp.json 从服务器上加载的路径（必须的配置项）
auto-download：是否自动下载热更新代码，默认是 true
auto-install：是否自动安装热更新代码，默认是 true
native-interface：当前 native side 的版本号

6、将打包具有热更新功能的sdk

运行cordova build android生成具有热更行功能的安卓app安装包。

7、测试热更新

这一步我是直接将项目更改后的的www文件夹放到服务器上，在cordova项目根目录运行 cordova-hcp build， 然后重启app，就可实现App的web内容代码的热更新了。需要注意的是www文件在服务地地址一定要与"content_url":"http://************/cordova/www"和config.xml中 填写的地址一致。

大概重启两次就可以更新了，
（何时更新update属性是start，第一次打开时下载资源，第二次打开才安装
是now：则可以打开之后，就进行下载更新）

拿这两个事件可以测试一下有没有触发事件

document.addEventListener('deviceready', onDeviceReady(), false);
function onDeviceReady(){
//安装成功
document.addEventListener('chcp_updateInstalled', onUpdateReady(), false);
//安装失败
document.addEventListener('chcp_updateInstallFailed', onUpdateReady2(), false);
}

额，两个事件都触发了我也不知道为啥，反正是能用

可用事件（转载自https://blog.csdn.net/ouyangli2011/article/details/107402349）

可用事件
	chcp_updateIsReadyToInstall - web内容已经下载并可以安装时触发.
	chcp_updateLoadFailed - 插件无法下载web更新时触发. 详细错误信息在事件参数里.
	chcp_nothingToUpdate - 无可用更新下载时触发.
	chcp_updateInstalled - web内容安装成功时触发.
	chcp_updateInstallFailed - web内容安装失败时触发. 详细错误信息在事件参数里.
	chcp_nothingToInstall -无可用更新安装时触发.
	chcp_assetsInstalledOnExternalStorage - 插件成功把app内置的web内容拷贝到外置存储中时触发. 你可能需要开发调试时用到这个事件，也许不会.
	chcp_assetsInstallationError -插件无法拷贝app内置的web内容到外置存储中时触发. 如果此事件发生了 - 插件不再工作. 也许是设备没有足够的存储空间导致.  详细错误信息在事件参数里.