cordova热更新cordova-hot-code-push

如果你在开发cordova的HybirdApp项目,那么你可能需要完成一个需求-热更新。
闲话不多说……假设你已经有以下环境:

  • 本地服务器(可以使用集成环境,比如wamp)
  • 一个cordova项目

正文

使用命令行工具(cmd之类),进入根目录(均代表cordova项目根目录),安装 热更新所需要的插件

// 笔者使用的cnpm,可换成npm、yarn等
$ cnpm install -g cordova-hot-code-push-cli
$ cordova plugin add cordova-hot-code-push-plugin

插件安装完成之后,在根目录创建cordova-hcp.json文件,写入内容(也可以使用cordova-hcp init命令创建):

{
  // 自动在native(iOS/Android)下生成文件链接标签
  "autogenerated": true,
  // 项目名称(自行替换)
  "name": "cn.com.cordovaApp",
  // 更新的方式,有三个选项:start(app启动时安装更新,默认值)、now(app从后台切换过来的时候安装更新)、resume(web内容下载完毕即安装更新)
  "update": "now",
  // 项目在服务器上面的地址(这里使用了笔者本地的服务器地址,自行替换)
  "content_url": "http://localhost/cordova/www"
}

然后继续在根目录的config.xml文件中加入以下这段:

<chcp>
    <config-file url="http://localhost/cordova/www/chcp.json"/>
</chcp>

还有根目录的.chcpenv文件,把路径改为一致:

{
  "content_url": "http://localhost/cordova/www",
  "config_url": "http://localhost/cordova/www/chcp.json"
}

到这里,基本上配置方面都已经完成了,开始工作:

// 在项目的www目录生成chcp.json以及chcp.manifest
$ cordova-hcp build
// 生成apk
$ cordova build android
// IOS使用xcode完成,此处不讲,因为热更新的方法是相同的

执行完cordova-hcp build可以把www的所有文件复制到http://localhost/cordova/www服务器地址中。
然后安装apk到手机上,此时安装工作也已经完成。

热更新的执行步骤

修改h5项目代码,依旧执行:

// 更新chcp.json的时间戳
$ cordova-hcp build

可以把www的所有文件复制到http://localhost/cordova/www服务器地址中。
重启APP后就可看到改动后的APP了。

注意

如果热更新不生效,可以启动手机的USB调试模式,然后访问Chrome调试工具进行调试(仅限Android):

chcp.fetchUpdate(function(error, data){
    console.log(error, data);
});

cordova-hot-code-push在cordova ready事件之后会提供一个全局chcp变量,在控制台打印更新的情况,如果error有值的话,可参考chcp error错误代码来进一步修改。

补充2017-11-14

以上教程的热更新属于自动化的,在用户完全不知情的情况下,于是就有了可选择更新的需求:

    <chcp>
        <auto-download enabled="false" />
        <auto-install enabled="false" />
        <config-file url="http://www.xxx.com/project/chcp.json" />
    </chcp>

在config.xml改成以上配置,取消自动下载,取消自动安装,然后通过插件提供的jsAPI进行手动更新,以下在deviceready事件触发中示例(仅供参考):

    document.addEventListener('deviceready', () => {
      let chcp = window.chcp;
      // 检测更新
      chcp.fetchUpdate((error, data) => {

        // 表示没有更新版本,或者其他错误,详情的信息参考上面的chcp error链接
        if (error) {
          console.log('--fetchUpdate error--', error.code, error.description);
          return;
        }

        // 这次更新的版本信息
        console.log('--fetchUpdate--', data, data.config);
        // 检测是否是否可以进行安装了,双重判断吧,有时候会出现有更新版本但是暂时无法安装的情况(也可以去掉这一层)
        chcp.isUpdateAvailableForInstallation((error, data) => {

          if (error) {
            console.log('No update was loaded => nothing to install');
          } else {
            // 询问用户是否更新
            if ( window.confirm('检测到新版本,是否更新') ) {
              // 更新中
              chcp.installUpdate((error) => {
                if (error) {
                  // 更新失败
                  console.log('Failed to install the update with error code: ' + error.code);
                  console.log(error.description);
                } else {
                  // 更新成功
                  console.log('Update installed!');
                }
              });
            } else {
              window.alert('您已拒绝更新');
            }
 
            // 对比版本号
            console.log('Current content version: ' + data.currentVersion);
            console.log('Ready to be installed:' + data.readyToInstallVersion);
          }

        });
      });
    });

另外补充个坑(Android上)

笔者是在原用zepto项目一步步重写成vue,使用了vue-router,然后难免有没有重写完成的页面(xxx.html,xxxx.html),这种我是使用了window.location.href = 'xxx.html'进行跳转(ps:这些xxx.html页面没有使用到原生功能,所以没有引入chcp之类的插件),然后发现在使用了chcp插件后,进行跳转后进行window.history.back()回退到上一个页面(vue页面,使用了chcp插件),会把vue-router的历史记录清空了……

原因应该是chcp初始化的时候,把历史记录清空了,可把这段清空操作注释了,打开cordova项目目录/plugins/cordova-hot-code-push-plugin/src/android/src/com/nordnetab/chcp/main/HotCodePushPlugin.java
搜索webView.clearHistory();,然后注释掉就好了

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 151,688评论 1 330
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 64,559评论 1 273
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 101,749评论 0 226
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 42,581评论 0 191
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 50,741评论 3 271
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 39,684评论 1 192
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,122评论 2 292
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,847评论 0 182
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,441评论 0 228
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,939评论 2 232
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,333评论 1 242
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,783评论 2 236
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,275评论 3 220
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,830评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,444评论 0 180
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 34,553评论 2 249
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 34,618评论 2 249

推荐阅读更多精彩内容