uniapp热更新和整包升级

一. uniapp热更新  (热更新官方文档)

　　很多人在开发uniapp的时候, 发现热更新失效问题(或者热更新没有更新manifest里的新增模块，SDK，原生插件包括云插件), 其实uniapp官网也写了

　　简单的来说,manifest里面的东西是, 就比如 app图标,启动屏, 增加了map模块等,勾选了其他的sdk,增加了原生插件等都会引起热更新问题,

　　这时候就需要整包升级。

　　

　　但是抛开这些 manifest的修改,热更新还是很方便的,代码如下:

　　

在 App.vue 的 onLaunch 中检测升级，代码如下：

// #ifdef APP-PLUS

plus.runtime.getProperty(plus.runtime.appid, function(widgetInfo) {

    uni.request({

        url: 'http://www.example.com/update/',

        data: {

            version: widgetInfo.version,

            name: widgetInfo.name

        },

        success: (result) => {

            var data = result.data;

            if (data.update && data.wgtUrl) {

                uni.downloadFile({

                    url: data.wgtUrl,

                    success: (downloadResult) => {

                        if (downloadResult.statusCode === 200) {

                            plus.runtime.install(downloadResult.tempFilePath, {

                                force: false  //是否校验版本 true不校验

                            }, function() {

                                console.log('install success...');

                                plus.runtime.restart();  //热更新要重新启动才能生效

                            }, function(e) {

                                console.error('install fail...');

                            });

                        }

                    }

                });

            }

        }

    });

});

// #endif

二. uniapp整包升级  (整包升级官方文档)

　　整包升级代码:

在App.vue的onLaunch中，发起升级检测请求，如下：

onLaunch: function () {

    //#ifdef APP-PLUS

    var server = "https://www.example.com/update"; //检查更新地址

    var req = { //升级检测数据

        "appid": plus.runtime.appid,

        "version": plus.runtime.version

    };

    uni.request({

        url: server,

        data: req,

        success: (res) => {

            if (res.statusCode == 200 && res.data.status === 1) {

                uni.showModal({ //提醒用户更新

                    title: "更新提示",

                    content: res.data.note,

                    success: (res) => {

                        if (res.confirm) {

                            plus.runtime.openURL(res.data.url);

                        }

                    }

                })

            }

        }

    })

    //#endif

}

注意：App的升级检测代码必须使用条件编译，否则在非App环境由于不存在plus相关API，将会报错。

升级地址URL，如果是自行托管的App，就提供自己的包地址。如果是打开应用市场，那URL如下：

if (plus.os.name=="Android") {

    appurl = "market://details?id=io.dcloud.hellouniapp"; //这个是通用应用市场，如果想指定某个应用商店，需要单独查这个应用商店的包名或scheme及参数

}

else{

    appurl = "itms-apps://itunes.apple.com/cn/app/hello-uni-app/id1417078253";

}

服务端实现

根据客户端上报的版本号，比对服务端最新版本号，决定是否需要升级，若需升级则返回升级信息（rease notes、更新包地址等）

实现示例：

【推荐】通过uniCloud的云函数模板，快速实现升级检查逻辑，详情参考：https://ext.dcloud.net.cn/plugin?id=4470
php示例代码：

　　

header("Content-type:text/json");

$appid = $_GET["appid"];

$version = $_GET["version"]; //客户端版本号

$rsp = array("status" => 0); //默认返回值，不需要升级

if (isset($appid) && isset($version)) {

    if ($appid === "__UNI__123456") { //校验appid

        if ($version !== "1.0.1") { //这里是示例代码，真实业务上，最新版本号及relase notes可以存储在数据库或文件中

            $rsp["status"] = 1;

            $rsp["note"] = "修复bug1；\n修复bug2;"; //release notes

            $rsp["url"] = "http://www.example.com/uniapp.apk"; //应用升级包下载地址

        }

    }

}

echo json_encode($rsp);

exit;

常见问题

版本检测需要打包app，真机运行基座无法测试。因为真机运行的plus.runtime.version是固定值。

uniapp热更新和整包升级的相关教程结束。