uni-app在App平台如何实现升级更新?

接口约定

如下数据接口约定仅为示例,开发者可以自定义接口参数。

请求地址:https://www.example.com/update(后端定义的接口)

请求方法:GET

请求数据:

{
    "appid": plus.runtime.appid,
    "version": plus.runtime.version
}

响应数据:

{
    "status":1,//升级标志,1:需要升级;0:无需升级
    "note": "修复bug1;\n修复bug2;",//release notes
    "url": "http://www.example.com/uniapp.apk" //更新包下载地址
}

客户端实现

App启动时,向服务端上报当前版本号,服务端判断是否提示升级。

在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") {
//这个是通用应用市场,如果想指定某个应用商店,需要单独查这个应用商店的包名或scheme及参数
    appurl = "market://details?id=io.dcloud.hellouniapp";
}
else{
    appurl = "itms-apps://itunes.apple.com/cn/app/hello-uni-app/id1417078253";
}

服务端实现

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

实现示例:

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

常见问题

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

app 内部升级更新

App.vue 文件


你可能感兴趣的:(uni-app在App平台如何实现升级更新?)