uni-app クロスプラットフォームアプリケーション開発により、オンラインリソースアップグレードが実現-uni-app-php.cn

この記事では、uniapp に関する関連知識を提供します。主に、リソースのオンラインアップグレードとホットアップデート関連の問題を実装する方法を紹介します。uni-app を使用してクロスターミナルアプリケーションを開発すると、コンパイルされたコードを使用できます。 iOS、Android、WeChat アプレット、その他のプラットフォームにアップグレードする場合は、マルチプラットフォームの同時アップグレードも考慮する必要があります。

uni-app クロスプラットフォームアプリケーション開発により、オンラインリソースアップグレードが実現

推奨: 「uniapp ビデオチュートリアル」

1. はじめに

uni-app の使用方法 クロスターミナルアプリケーションを開発するには、コードを iOS、Android、WeChat アプレット、その他のプラットフォームにコンパイルできます。アップグレードする場合は、マルチプラットフォームの同時アップグレードも考慮する必要があります。。その中でも、ミニプログラムとして公開されている uni-app のアップグレードモードは比較的簡単で、開発したコードをミニプログラムのバックグラウンドに送信するだけで、レビューが通過すると自動的にアップグレードされます。。

HBuilderX 1.6.5 以降、uni-app は App リソースアップグレードパッケージ wgt の生成をサポートします。

2. Wgt リソースアップグレードパッケージのアップグレード

2.1 バージョン番号の変更

まず、manifest.json のバージョン番号を更新します。
たとえば、以前が 1.0.0 だった場合、新しいバージョンは 1.0.1 または 1.1.0 になります。
uni-app クロスプラットフォームアプリケーション開発により、オンラインリソースアップグレードが実現

2.2 Release

次に、HBuilderX でアップグレードパッケージ (wgt) を生成します。

菜单->发行->原生App-制作移动App资源升级包

ログイン後にコピー

uni-app クロスプラットフォームアプリケーション開発により、オンラインリソースアップグレードが実現
生成が完了すると、アップグレードパッケージの出力場所がコンソールに通知されます。

2.3 リソースアップグレードパッケージのインストール

アプリケーションのアップグレードにはサーバーとクライアントの協力が必要です。以下はローカルテストプロセスでの操作の例です。 :

リソースの保存
%appid%.wgt ファイルをサーバーの static ディレクトリ、つまり http://www.example.com/static/UNI832D722.wgt。

サーバーインターフェイス
アップグレードを検出するための合意されたインターフェイス、アドレスは次のとおりです: http://www.example.com/update/

受信パラメータ

name String '' クライアントによって読み取られたアプリケーション名。このパラメータを定義すると、複数のアプリケーションによるインターフェイスの再利用が容易になります。。
#version String '' クライアントによって読み取られたバージョン番号情報

戻りパラメータ

ブール値 false アップデートがあるかどうか
文字列 wgt wgt## に使用されるパッケージのダウンロードアドレス# メソッドの更新。 pkgUrl
apk/ipa パッケージのダウンロードアドレスまたは AppStore アドレス。パッケージ全体のアップグレードに使用されます。 2.3.1 コード例

以下はサーバー側の判定の簡単な例ですが、あくまで参考であり、実際の開発では独自の処理に従って処理されます。ビジネスニーズ。

var express = require('express');  var router = express.Router();  var db = require('./db');  // TODO 查询配置文件或者数据库信息来确认是否有更新  
function checkUpdate(params, callback) {  
    db.query('一段SQL', function(error, result) {  
        // 这里简单判定下，不相等就是有更新。  
        var currentVersions = params.appVersion.split('.');  
        var resultVersions = result.appVersion.split('.');  

        if (currentVersions[0]

ログイン後にコピー

注意事項

サーバーの具体的な判定ロジックはお客様のビジネスロジックに合わせて柔軟に対応してください。

クライアント検出アップグレード

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  
                            }, function() {  
                                console.log('install success...');  
                                plus.runtime.restart();  
                            }, function(e) {  
                                console.error('install fail...');  
                            });  
                        }  
                    }  
                });  
            }  
        }  
    });  });  // #endif

ログイン後にコピー

リソースアップグレードパッケージは次のようにサポートされていません:

SDK

Maps の追加など、一部の部分が調整されました。この方法は使用できません。アップグレードするには、パッケージ全体をアップグレードする必要があります。 ネイティブプラグインへの追加や変更でも、この方法は使用できません。
nvue
nvue ファイルが追加された場合について説明する必要があります。アップデートの場合、この方法は使用できません。非カスタムコンポーネントコンパイルモードでは、nvue ファイルなしでは weex エンジンがパッケージ化されず、ネイティブエンジンを動的に追加できないためです。カスタムコンポーネントモードには、プロジェクトに nvue ファイルがあるかどうかに関係なく、デフォルトで weexエンジンが含まれます。＃＃＃＃＃＃＃＃＃＃＃＃予防＃＃＃＃＃＃<ul> <li>条件编译，仅在 <code>App 平台执行此升级逻辑。
appid 以及版本信息等，在 HBuilderX 真机运行开发期间，均为 HBuilder 这个应用的信息，因此需要打包自定义基座或正式包测试升级功能。
plus.runtime.version 或者 uni.getSystemInfo() 读取到的是 apk/ipa 包的版本号，而非 manifest.json 资源中的版本信息，所以这里用 plus.runtime.getProperty() 来获取相关信息。
安装 wgt 资源包成功后，必须执行 plus.runtime.restart()，否则新的内容并不会生效。
如果App的原生引擎不升级，只升级wgt包时需要注意测试wgt资源和原生基座的兼容性⚠️。平台默认会对不匹配的版本进行提醒，如果自测没问题，可以在manifestt.json中配置忽略提示。
应用市场为了防止开发者不经市场审核许可，给用户提供违法内容，对热更新大多持排斥态度。

但实际上热更新使用非常普遍，不管是原生开发中还是跨平台开发。

Apple曾经禁止过jspatch，但没有打击其他的热更新方案，包括cordovar、react native、DCloud。封杀jspatch其实是因为jspatch有严重安全漏洞，可以被黑客利用，造成三方黑客可篡改其他App的数据。

使用热更新需要注意：

上架审核期间不要弹出热更新提示；
热更新内容使用https下载，避免被三方网络劫持；
不要更新违法内容、不要通过热更新破坏应用市场的利益，比如iOS的虚拟支付要老老实实给Apple分钱。

三、整包升级

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

请求地址：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" //更新包下载地址  
}

ログイン後にコピー

3.1 客户端实现

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的升级检测代码必须使用条件编译，否则在微信环境由于不存在plus相关API，将会报错。

3.2 数据表实现

需维护一张数据表，用于维护APP版本信息，主要字段信息如下：

字段名称	数据类型	数据说明
`AppID`	`varchar`	mobile AppID
`version`	`varchar`	应用市场版本号
`notes`	`varchar`	版本更新说明
`url`	`varchar`	应用市场下载URL。注意：根据谷歌、App Store应用市场审核规范，应用升级只能通过提交应用市场更新，不能通过下载`apk`、`IPA`安装方式更新应用。

3.3 服务端实现

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

开发者可以根据服务端开发语言，自己实现升级检测逻辑，如下是一个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;

ログイン後にコピー

注意事项：

plus.runtime.appid，plus.runtime.version， plus.runtime.openURL(） 在真机环境下才有效。
版本检测需要打包app，真机运行基座无法测试。因为真机运行的plus.runtime.version是固定值。
根据谷歌应用市场的审核规范，应用升级只能通过提交应用市场更新，不能通过下载apk安装方式更新应用。apk安装失败可能是因为缺少android.permission.INSTALL_PACKAGES、android.permission.REQUEST_INSTALL_PACKAGES权限导致，注意：添加上面两个权限无法通过谷歌审核。

四、Uni-app 版本升级中心

uni-app提供了一整套版本维护框架，包含升级中心uni-upgrade-center - Admin、前台检测更新uni-upgrade-center-app。

4.1 升级中心 uni-upgrade-center - Admin

uni-app提供了版本维护后台应用升级中心uni-upgrade-center - Admin，升级中心是一款uni-admin插件，负责App版本更新业务。包含后台管理界面、更新检查逻辑，App内只要调用弹出提示即可。
uni-app クロスプラットフォームアプリケーション開発により、オンラインリソースアップグレードが実現
在上传安装包界面填写此次发版信息，其中包地址可以选择手动上传一个文件到云存储，会自动将地址填入该项。

也可以手动填写一个地址（例如：https://appgallery.huawei.com/app/C10764638），就可以不用再上传文件。

如果是发布苹果版本，包地址则为应用在AppStore的链接。
uni-app クロスプラットフォームアプリケーション開発により、オンラインリソースアップグレードが実現
升级中心有以下功能点：

云储存安装包CDN加速，使安装包下载的更快、更稳定

应用管理，对App的信息记录和应用版本管理。

版本管理，可以发布新版，也可方便直观的对当前App历史版本以及线上发行版本进行查看、编辑和删除操作。

版本发布信息管理，包括更新标题，内容，版本号，静默更新，强制更新，灵活上线发行的设置和修改。

原生App安装包，发布Apk更新，用于App的整包更新，可设置是否强制更新。

wgt资源包，发布wgt更新，用于App的热更新，可设置是否强制更新，静默更新。

App管理列表及App版本记录列表搜索。

只需导入插件，初始化数据库即可拥有上述功能。

也可以自己修改逻辑自定义数据库字段，和随意定制 UI 样式。

4.2 前台检测更新 uni-upgrade-center-app

uni-upgrade-center-app 负责前台检查升级更新。

项目结构如下图所示：
uni-app クロスプラットフォームアプリケーション開発により、オンラインリソースアップグレードが実現
检测更新视图如下图所示：

该插件提供如下功能：

#統合管理
App および App (Android、iOS プラットフォーム App)インストールパッケージと wgt リソースパッケージのリリースとアップグレード。

uni-upgrade-center ワンクリック更新チェックに基づいて、パッケージ全体と wgt リソースパッケージ更新を統合します。
渡されたパラメーターに基づいて検証を完了し、この更新に使用する方法を決定します。
ワンクリックでアップグレード。ポップアップボックス、ダウンロード、インストール、強制再起動などのロジックが統合されています。
ダウンロードが完了し、アップグレードをキャンセルすると、インストールパッケージは自動的にキャッシュされ、次回入力時にインストール条件を満たしているか判定されます。判定に失敗した場合は、自動的にクリアされます。
美しく、実用的で、カスタマイズ可能。