Die plattformübergreifende Anwendungsentwicklung von Uni-App realisiert ein Online-Ressourcen-Upgrade-uni-app-php.cn

Dieser Artikel vermittelt Ihnen relevantes Wissen über uniapp. Er stellt hauptsächlich vor, wie Sie mit Uni-App Probleme im Zusammenhang mit der Aktualisierung von Online-Ressourcen lösen können. Der Code kann für iOS, Android usw. kompiliert werden Wenn Sie Plattformen wie WeChat-Miniprogramme aktualisieren, müssen Sie auch gleichzeitige Upgrades auf mehreren Plattformen in Betracht ziehen. Ich hoffe, dass dies für alle hilfreich ist.

Die plattformübergreifende Anwendungsentwicklung von Uni-App realisiert ein Online-Ressourcen-Upgrade

1. Einführung

Verwenden Sie uni-app, um terminalübergreifende Anwendungen zu entwickeln, und der Code kann auf iOS kompiliert werden , Android, WeChat-Applet und andere Plattformen. Beim Upgrade müssen Sie auch gleichzeitige Upgrades auf mehreren Plattformen in Betracht ziehen. Unter anderem ist der Upgrade-Modus von uni-app, der als Miniprogramm veröffentlicht wird, relativ einfach. Sie müssen nur den entwickelten Code an das Miniprogramm-Backend senden, und Benutzer werden nach der Genehmigung automatisch aktualisiert. uni-app 开发跨终端应用，可将代码编译到iOS、Android、微信小程序等多个平台，升级时也需考虑多平台同步升级。其中，uni-app发布为小程序的升级模式较简单，只需将开发完的代码提交小程序后台，待审核通过后用户将自动升级。

HBuilderX 1.6.5 起，uni-app 支持生成 App 资源升级包wgt。

二、wgt 资源升级包升级

2.1 修改版本号

首先，更新 manifest.json 中的版本号。
比如之前是 1.0.0，那么新版本应该是 1.0.1 或 1.1.0 这样。
Die plattformübergreifende Anwendungsentwicklung von Uni-App realisiert ein Online-Ressourcen-Upgrade

2.2 发行

然后，在 HBuilderX 中生成升级包（wgt）。

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

Nach dem Login kopieren

Die plattformübergreifende Anwendungsentwicklung von Uni-App realisiert ein Online-Ressourcen-Upgrade
生成结束会在控制台告知升级包的输出位置。

2.3 安装资源升级包

应用的升级需要服务端与客户端配合完成，下面以本地测试过程中的操作举例说明：

存放资源
将 %appid%.wgt 文件存放在服务器的 static 目录下，即 http://www.example.com/static/UNI832D722.wgt。

服务端接口
约定检测升级的接口，地址为：http://www.example.com/update/

传入参数

name String ‘’ 客户端读取到的应用名称，定义这个参数可以方便多个应用复用接口。
version String ‘’ 客户端读取到的版本号信息

返回参数

update Boolean false 是否有更新
wgtUrl String wgt 包的下载地址，用于 wgt 方式更新。
pkgUrl String 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] <p>注意事项</p>

Nach dem Login kopieren

服务端的具体判定逻辑，请根据自身的业务逻辑灵活处理。
应用中的路径尽量不要包含特殊符号。

客户端检测升级
在 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

Nach dem Login kopieren

不支持资源升级包情况如下：

SDK 部分有调整，比如新增了 Maps 模块等，不可通过此方式升级，必须通过整包的方式升级。
原生插件的增改，同样不能使用此方式。
对于老的非自定义组件编译模式，这种模式已经被淘汰下线。但以防万一也需要说明下，老的非自定义组件编译模式，如果之前工程没有 nvue 文件，但更新中新增了 nvue 文件，不能使用此方式。因为非自定义组件编译模式如果没有nvue文件是不会打包weex引擎进去的，原生引擎无法动态添加。自定义组件模式默认就含着weex引擎，不管工程下有没有nvue

HBuilderX 1.6.5

uni-app

App

wgt

2. Wgt-Ressourcen-Upgrade-Paket-Upgrade

2.1 Versionsnummer ändern

Aktualisieren Sie zunächst die Versionsnummer in manifest.json.
Wenn es beispielsweise vorher 1.0.0 war, dann sollte die neue Version 1.0.1 oder 1.1.0 sein.
Bildbeschreibung hier einfügen

2.2 Release

🎜Dann generieren Sie das Upgrade-Paket (wgt) in HBuilderX. 🎜

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

Nach dem Login kopieren

🎜

Generieren bei Am Ende wird der Ausgabeort des Upgrade-Pakets auf der Konsole angezeigt.
Bildbeschreibung hier einfügen

🎜

2.3 Installieren Sie das Ressourcen-Upgrade-Paket

🎜Das Aktualisieren der Anwendung erfordert die Zusammenarbeit des Servers und des Clients. Das Folgende ist ein Beispiel für den Vorgang während des lokalen Testprozesses: 🎜🎜🎜Speichern von Ressourcen🎜
Ersetzen Sie %appid% Die .wgt-Datei wird im Verzeichnis static des Servers gespeichert, also http://www.example.com/static/UNI832D722.wgt . 🎜🎜🎜Serverschnittstelle🎜
Vereinbart zur Erkennung der Upgrade-Schnittstelle, die Adresse lautet: http://www.example.com/update/🎜🎜🎜Eingehende Parameter🎜🎜

name String '' Der vom Client gelesene Anwendungsname kann die Wiederverwendung der Schnittstelle durch mehrere Anwendungen erleichtern. 🎜

version String '' Die vom Client gelesenen Versionsnummerninformationen🎜🎜🎜🎜Rückgabeparameter🎜🎜

update Boolean false Ob vorhanden Update🎜
wgtUrl String wgt Die Download-Adresse des Pakets, die für das wgt-Update verwendet wird. 🎜

pkgUrl String apk/ipa-Paket-Download-Adresse oder AppStore-Adresse, wird für das Upgrade des gesamten Pakets verwendet. 🎜🎜

2.3.1 Codebeispiel

🎜Das Folgende ist ein einfaches Beispiel für die serverseitige Bestimmung. Es dient nur als Referenz. Es wird entsprechend Ihren eigenen Geschäftsanforderungen verarbeitet. 🎜

{  
    "status":1,//升级标志，1：需要升级；0：无需升级  `在这里插入代码片`    "note": "修复bug1；\n修复bug2;",//release notes  
    "url": "http://www.example.com/uniapp.apk" //更新包下载地址  
}

Nach dem Login kopieren

🎜Hinweise🎜

Bitte gehen Sie flexibel mit der spezifischen Beurteilungslogik des Servers entsprechend Ihrer eigenen Geschäftslogik um. 🎜

Versuchen Sie, keine speziellen Symbole in den Pfad der Anwendung aufzunehmen. 🎜🎜🎜Client erkennt Upgrades
Erkennen Sie Upgrades in onLaunch von App.vue. Der Code lautet wie folgt: 🎜

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  }

Nach dem Login kopieren

🎜🎜Die Situation, in der sich Ressourcen-Upgrade-Pakete befinden Nicht unterstützt lautet wie folgt: 🎜🎜

Der SDK-Teil wurde angepasst, z. B. das Hinzufügen des Maps-Moduls usw. Es kann nicht aktualisiert werden über diese Methode und muss über das gesamte Paket aktualisiert werden. 🎜
Diese Methode kann nicht für Ergänzungen und Änderungen an nativen Plug-Ins verwendet werden. 🎜

Für den alten Kompilierungsmodus für nicht benutzerdefinierte Komponenten wurde dieser Modus entfernt. Aber für alle Fälle muss ich das im alten Kompilierungsmodus für nicht benutzerdefinierte Komponenten erklären, wenn das vorherige Projekt keine nvue-Datei, sondern eine neue nvue-Datei hatte wurde im Update hinzugefügt, es wird nicht funktionieren. Da der Kompilierungsmodus für nicht benutzerdefinierte Komponenten die weex-Engine nicht ohne die nvue-Datei packt und die native Engine nicht dynamisch hinzugefügt werden kann. Der benutzerdefinierte Komponentenmodus umfasst standardmäßig die weex-Engine, unabhängig davon, ob sich unter dem Projekt eine nvue-Datei befindet. 🎜🎜🎜🎜Notizen🎜🎜

条件编译，仅在 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  
}

Nach dem Login kopieren

响应数据：

{  
    "status":1,//升级标志，1：需要升级；0：无需升级  `在这里插入代码片`    "note": "修复bug1；\n修复bug2;",//release notes  
    "url": "http://www.example.com/uniapp.apk" //更新包下载地址  
}

Nach dem Login kopieren

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  }

Nach dem Login kopieren

注意：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;

Nach dem Login kopieren

注意事项：

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内只要调用弹出提示即可。
Die plattformübergreifende Anwendungsentwicklung von Uni-App realisiert ein Online-Ressourcen-Upgrade
在上传安装包界面填写此次发版信息，其中包地址可以选择手动上传一个文件到云存储，会自动将地址填入该项。

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

如果是发布苹果版本，包地址则为应用在AppStore的链接。
Die plattformübergreifende Anwendungsentwicklung von Uni-App realisiert ein Online-Ressourcen-Upgrade
升级中心有以下功能点：

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

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

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

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

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

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

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

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

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

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

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

项目结构如下图所示：
Die plattformübergreifende Anwendungsentwicklung von Uni-App realisiert ein Online-Ressourcen-Upgrade
检测更新视图如下图所示：

该插件提供如下功能：

Einheitliche Verwaltung von App und App auf Android- und iOS-Plattformen App Veröffentlichung und Upgrade von Installationspaketen und wgt-Ressourcenpaketen. App及App在Android、iOS平台上App安装包和wgt资源包的发布升级。

基于uni-upgrade-center一键式检查更新，统一整包与 wgt
Basierend auf uni-upgrade-center, Ein-Klick-Suche nach Updates, Vereinheitlichung des gesamten Pakets und wgt Ressourcenpaketaktualisierungen.
Schließen Sie die Überprüfung anhand der übergebenen Parameter ab, um zu bestimmen, welche Methode für dieses Update verwendet werden soll.
Upgrade mit einem Klick. Logiken wie Popup-Boxen, Downloads, Installationen, erzwungene Neustarts usw. wurden integriert.
Wenn der Download abgeschlossen ist und das Upgrade abgebrochen wird, wird das Installationspaket automatisch zwischengespeichert. Bei der nächsten Eingabe wird beurteilt, ob es die Installationsbedingungen erfüllt. Wenn die Beurteilung fehlschlägt, wird es automatisch gelöscht.
Schön, praktisch und anpassbar.

Hinweis: Die Versionsnummer und appid, die beim Ausführen auf der Mobiltelefonbasis erhalten werden, sind die Versionen von hbuilder und hbuilder

und müssen manuell in der Datei festgelegt werden.

4.3 Funktionsprinzip

Upgrade-Center uni-upgrade-center – Der Administrator ist für die Pflege der Versionsinformationen und die Pflege der Versionsinformationen in der Datenbank verantwortlich.

Das Front-End-Erkennungs- und Update-Plug-in uni-upgrade-center-app ist für die Überprüfung und Aktualisierung mit einem Klick verantwortlich, indem es Cloud-Funktionen aufruft, um die von der Datenbank verwalteten Versionsinformationen zu lesen.