Maison >interface Web >uni-app >Le développement d'applications multiplateformes Uni-App réalise une mise à niveau des ressources en ligne
Cet article vous apporte des connaissances pertinentes sur uniapp. Il présente principalement comment réaliser la mise à niveau des ressources en ligne et les problèmes liés aux mises à jour à chaud. Utilisez uni-app pour développer des applications multi-terminaux et compiler le code sur iOS, Android, lors de la mise à niveau de plates-formes telles. en tant que mini-programmes WeChat, vous devez également envisager des mises à niveau simultanées multiplateformes. J'espère que cela sera utile à tout le monde.
Recommandé : "Tutoriel vidéo uniapp"
Utilisez uni-app
pour développer des applications multi-terminaux, et le code peut être compilé sur iOS.
, Android
, applet WeChat et autres plates-formes lors de la mise à niveau, vous devez également envisager des mises à niveau simultanées multiplateformes. Parmi eux, le mode de mise à niveau de uni-app
publié sous forme de mini-programme est relativement simple. Il vous suffit de soumettre le code développé au backend du mini-programme, et les utilisateurs seront automatiquement mis à niveau après approbation. uni-app
开发跨终端应用,可将代码编译到iOS
、Android
、微信小程序等多个平台,升级时也需考虑多平台同步升级。其中,uni-app
发布为小程序的升级模式较简单,只需将开发完的代码提交小程序后台,待审核通过后用户将自动升级。
HBuilderX 1.6.5
起,uni-app
支持生成 App
资源升级包wgt
。
首先,更新 manifest.json
中的版本号。
比如之前是 1.0.0
,那么新版本应该是 1.0.1
或 1.1.0
这样。
然后,在 HBuilderX
中生成升级包(wgt
)。
菜单->发行->原生App-制作移动App资源升级包
生成结束会在控制台告知升级包的输出位置。
应用的升级需要服务端与客户端配合完成,下面以本地测试过程中的操作举例说明:
存放资源
将 %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
地址,用于整包升级的方式。下面是一个简单的服务端判定的示例,仅做参考,实际开发中根据自身业务需求处理。
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>
客户端检测升级
在 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
引擎进去的,原生引擎无法动态添加。自定义组件模式默认就含着weex
引擎,不管工程下有没有nvue
HBuilderX 1.6.5
, uni-app
prend en charge la génération du package de mise à niveau des ressources App
wgt
. 2. Mise à niveau du package de mise à niveau des ressources Wgt2.1 Modifier le numéro de version
Tout d'abord, mettez à jour le numéro de version dans manifest.json
.
Par exemple, s'il s'agissait de 1.0.0
auparavant, alors la nouvelle version devrait être 1.0.1
ou 1.1.0
.
wgt
) dans HBuilderX
. 🎜{ "appid": plus.runtime.appid, "version": plus.runtime.version }🎜
http://www.example.com/static/UNI832D722.wgt
. 🎜🎜🎜Interface serveur🎜http://www.example.com/update/
🎜🎜🎜Paramètres entrants🎜🎜name
String '' Le nom de l'application lu par le client La définition de ce paramètre peut faciliter la réutilisation de l'interface par plusieurs applications. 🎜version
String '' Les informations sur le numéro de version lues par le client🎜🎜🎜🎜Paramètres de retour🎜🎜update
Booléen false Y en a-t-il Update🎜wgtUrl
String Adresse de téléchargement du package wgt
, utilisée pour la mise à jour de wgt
. 🎜pkgUrl
String Adresse de téléchargement du package apk/ipa
ou adresse AppStore
, utilisée pour la mise à niveau complète du package. 🎜🎜{ "status":1,//升级标志,1:需要升级;0:无需升级 `在这里插入代码片` "note": "修复bug1;\n修复bug2;",//release notes "url": "http://www.example.com/uniapp.apk" //更新包下载地址 }🎜Notes🎜
onLaunch
de App.vue
Le code est le suivant : 🎜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 }🎜🎜La situation dans laquelle se trouvent les packages de mise à niveau de ressources. non supporté est le suivant : 🎜🎜
SDK
a été ajustée, comme l'ajout du module Maps
, etc. Elle ne peut pas être mise à niveau via cette méthode et doit être mis à niveau via l’ensemble du package. 🎜nvue
, mais un nouveau fichier nvue
a été ajouté dans la mise à jour, cela ne fonctionnera pas. Utilisez cette méthode. Parce que le mode de compilation des composants non personnalisés ne conditionnera pas le moteur weex
sans le fichier nvue
et que le moteur natif ne peut pas être ajouté dynamiquement. Le mode composant personnalisé inclut le moteur weex
par défaut, qu'il existe ou non un fichier nvue
sous le projet. 🎜🎜🎜🎜Notes🎜🎜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" //更新包下载地址 }
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
,将会报错。
需维护一张数据表,用于维护APP
版本信息,主要字段信息如下:
字段名称 | 数据类型 | 数据说明 |
---|---|---|
AppID |
varchar |
mobile AppID |
version |
varchar |
应用市场版本号 |
notes |
varchar |
版本更新说明 |
url |
varchar |
应用市场下载URL。 注意:根据谷歌、App Store应用市场审核规范,应用升级只能通过提交应用市场更新,不能通过下载apk 、IPA 安装方式更新应用。 |
根据客户端接收的版本号,比对服务端最新版本号,决定是否需要升级,若需升级则返回升级信息(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-upgrade-center - Admin
、前台检测更新uni-upgrade-center-app
。
uni-app
提供了版本维护后台应用升级中心uni-upgrade-center - Admin
,升级中心是一款uni-admin
插件,负责App
版本更新业务。包含后台管理界面、更新检查逻辑,App
内只要调用弹出提示即可。
在上传安装包界面填写此次发版信息,其中包地址可以选择手动上传一个文件到云存储,会自动将地址填入该项。
也可以手动填写一个地址(例如:https://appgallery.huawei.com/app/C10764638),就可以不用再上传文件。
如果是发布苹果版本,包地址则为应用在AppStore
的链接。
升级中心有以下功能点:
- 云储存安装包
CDN
加速,使安装包下载的更快、更稳定- 应用管理,对
App
的信息记录和应用版本管理。- 版本管理,可以发布新版,也可方便直观的对当前
App
历史版本以及线上发行版本进行查看、编辑和删除操作。- 版本发布信息管理,包括更新标题,内容,版本号,静默更新,强制更新,灵活上线发行的设置和修改。
- 原生
App
安装包,发布Apk
更新,用于App
的整包更新,可设置是否强制更新。wgt
资源包,发布wgt
更新,用于App
的热更新,可设置是否强制更新,静默更新。- App管理列表及App版本记录列表搜索。
- 只需导入插件,初始化数据库即可拥有上述功能。
- 也可以自己修改逻辑自定义数据库字段,和随意定制 UI 样式。
uni-upgrade-center-app
负责前台检查升级更新。
项目结构如下图所示:
检测更新视图如下图所示:
该插件提供如下功能:
- Gestion unifiée de
App
etApp
sur les plateformesAndroid
etiOS
App
Publication et mise à niveau des packages d'installation et des packages de ressourceswgt
.App
及App
在Android
、iOS
平台上App
安装包和wgt
资源包的发布升级。- 基于
Basé suruni-upgrade-center
一键式检查更新,统一整包与wgt
uni-upgrade-center
, vérification des mises à jour en un clic, unifiant l'ensemble du package et les mises à jour du package de ressourceswgt
.- Complétez la vérification en fonction des paramètres transmis pour déterminer quelle méthode utiliser pour cette mise à jour.
- Mise à niveau en un clic. Des logiques telles que des boîtes pop-up, des téléchargements, des installations, des redémarrages forcés, etc. ont été intégrées.
- Si le téléchargement est terminé et la mise à niveau est annulée, le package d'installation sera automatiquement mis en cache la prochaine fois que vous le saisirez, il sera jugé s'il répond aux conditions d'installation. Si le jugement échoue, il sera automatiquement effacé.
- Beau, pratique et personnalisable.
Remarque : Le numéro de version et le appid obtenus lors de l'exécution sur la base du téléphone mobile sont les versions de hbuilder et hbuilder
et doivent être définis manuellement dans le fichier. 4.3 Principe de fonctionnement
Centre de mise à niveau uni-upgrade-center - L'administrateur est responsable de la maintenance des informations de version et de la maintenance des informations de version dans la base de données.
Recommandé : "tutoriel uniapp
"🎜Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!