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、更新包地址等）

实现示例：

1. 【推荐】通过uniCloud的云函数模板，快速实现升级检查逻辑，详情参考：https://ext.dcloud.net.cn/plugin?id=4470
2. 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;

常见问题

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