【uniapp 开发】uni-app 资源在线升级/热更新
<p>注：本文为前端代码资源热更新。如果是整包升级，另见文档 https://ask.dcloud.net.cn/article/34972</p><p>HBuilderX 1.6.5 起，uni-app 支持生成 App 资源升级包。</p>
<h2 id="生成-app-资源升级包">生成 App 资源升级包</h2>
<h2 id="修改版本号">修改版本号</h2>
<p>首先，更新 manifest.json 中的版本号。<br>
比如之前是 1.0.0，那么新版本应该是 1.0.1 或 1.1.0 这样。</p>
<p><img src="https://img2018.cnblogs.com/blog/1162622/201908/1162622-20190805212545859-391318637.png"></p>
<h2 id="发行">发行</h2>
<p>然后，在 HBuilderX 中生成升级包（wgt）。<br>
菜单->发行->原生App-制作移动App资源升级包</p>
<p><img src="https://img2018.cnblogs.com/blog/1162622/201908/1162622-20190805212658180-98052171.png"></p>
<p>生成结束会在控制台告知升级包的输出位置。<br>
<img src="https://img2018.cnblogs.com/blog/1162622/201908/1162622-20190805212711023-331911084.png"></p>
<h2 id="安装资源升级包">安装资源升级包</h2>
<p>应用的升级需要服务端与客户端配合完成，下面以本地测试过程中的操作举例说明：</p>
<h2 id="存放资源">存放资源</h2>
<p>将 %appid%.wgt 文件存放在服务器的 static 目录下，即 http://www.example.com/static/UNI832D722.wgt。</p>
<h2 id="客户端检测升级">客户端检测升级</h2>
<p>在 App.vue 的 onLaunch 中检测升级，代码如下：</p>
<pre><code>// #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
</code></pre>
<h2 id="不支持的情况">不支持的情况</h2>
<ul>
<li>SDK 部分有调整，比如新增了 Maps 模块等，不可通过此方式升级，必须通过整包的方式升级。</li>
<li>如果是老的非自定义组件编译模式，之前没有 nvue 文件，但更新中新增了 nvue 文件，不能使用此方式。因为非自定义组件编译模式如果没有nvue文件是不会打包weex引擎进去的，原生引擎无法动态添加。自定义组件模式默认就含着weex引擎，不管工程下有没有nvue文件。</li>
<li>原生插件的增改，同样不能使用此方式。</li>
</ul>
<h2 id="注意事项">注意事项</h2>
<ul>
<li>条件编译，仅在 App 平台执行此升级逻辑。</li>
<li>appid 以及版本信息等，在 HBuilderX 真机运行开发期间，均为 HBuilder 这个应用的信息，因此需要打包自定义基座或正式包测试升级功能。</li>
<li>plus.runtime.version 或者 uni.getSystemInfo() 读取到的是 apk/ipa 包的版本号，而非 manifest.json 资源中的版本信息，所以这里用 plus.runtime.getProperty() 来获取相关信息。</li>
<li>安装 wgt 资源包成功后，必须执行 plus.runtime.restart()，否则新的内容并不会生效。</li>
<li>如果App的原生引擎不升级，只升级wgt包时需要注意测试wgt资源和原生基座的兼容性。平台默认会对不匹配的版本进行提醒，如果自测没问题，可以在manifest中配置忽略提示，详见https://ask.dcloud.net.cn/article/35627</li>
<li>www.example.com 是一个仅用做示例说明的地址，实际应用中应该是真实的 IP 或有效域名，请勿直接复制粘贴使用。</li>
</ul>
<h2 id="关于热更新是否影响应用上架">关于热更新是否影响应用上架</h2>
<p>应用市场为了防止开发者不经市场审核许可，给用户提供违法内容，对热更新大多持排斥态度。</p>
<p>但实际上热更新使用非常普遍，不管是原生开发中还是跨平台开发。</p>
<p>Apple曾经禁止过jspatch，但没有打击其他的热更新方案，包括cordovar、react native、DCloud。封杀jspatch其实是因为jspatch有严重安全漏洞，可以被黑客利用，造成三方黑客可篡改其他App的数据。</p>
<p>使用热更新需要注意：</p>
<ul>
<li>上架审核期间不要弹出热更新提示</li>
<li>热更新内容使用https下载，避免被三方网络劫持</li>
<li>不要更新违法内容、不要通过热更新破坏应用市场的利益，比如iOS的虚拟支付要老老实实给Apple分钱</li>
<li>如果你的应用没有犯这些错误，应用市场是不会管的。</li>
</ul><br><br>
来源：https://www.cnblogs.com/neo-java/p/11305638.html
頁:
[1]