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

野性酷女 2023-02-12 10:25 1阅读 0赞

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

又找到的一个感觉不错，可以让用户决定是否进行安装，而且也较为详细  
[https://www.jianshu.com/p/cb45fbc93a8b][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`标签里面即可）

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内容到外置存储中时触发. 如果此事件发生了 - 插件不再工作. 也许是设备没有足够的存储空间导致.  详细错误信息在事件参数里.

[https_www.cnblogs.com_changzz_p_10763986.html]: https://www.cnblogs.com/changzz/p/10763986.html
[https_www.jianshu.com_p_cb45fbc93a8b]: https://www.jianshu.com/p/cb45fbc93a8b