必须等plus.ready就绪后再调用plus.runtime.getProperty，冷启动时在onLaunch直接读取会返回空或报错；需用plus.ready包裹并传appid获取version，开发环境应跳过，版本比对须用语义化compareVersion函数，禁用字符串比较。
plus.runtime.getProperty 必须等 plus.ready 后再调用
冷启动时直接在 onLaunch 里读取 plus.runtime.version，大概率返回空或报错，尤其在低端安卓机上。H5+ 环境未初始化完成，plus.runtime 对象不可用是常态。
正确做法是包裹在 plus.ready 回调中：
<pre class="brush:php;toolbar:false;">plus.ready(() => {
plus.runtime.getProperty(plus.runtime.appid, (widgetInfo) => {
const currentVersion = widgetInfo.version; // ✅ 安全获取
// 后续比对、请求服务端逻辑放这里
});
});
开发环境务必加判断跳过，避免反复弹窗干扰调试：
if (process.env.NODE_ENV === 'development') return;- 首页有登录态或网络依赖的，建议把检查逻辑挪到
onShow或路由守卫后触发，而非强绑onLaunch
compareVersion 函数必须用于语义比对，不能用字符串相等或 > 直接比较
版本号 “1.9.0” 和 “1.10.0” 字符串比较结果是 "1.9.0" > "1.10.0"（字典序），但实际后者才是新版——这是最常踩的坑。
uni-app 社区验证过的 compareVersion 是按点分段转数字逐位比对，能正确处理：
- 常规格式：
"1.2.3" - 省略格式：
"1.2" - 带后缀格式：
"1.2.0-beta"（自动截断非数字部分）
示例用法：
<pre class="brush:php;toolbar:false;">const res = compareVersion('1.9.0', '1.10.0'); // 返回 -1，说明前者旧
if (res < 0) {
// 触发更新
}
服务端返回的 version 字段也必须规范：纯数字点分格式，禁止 <code>"v1.2.0"、"1.2.0.20260327"、前导零等不规则写法。
安卓 8+ 静默安装需 REQUEST_INSTALL_PACKAGES 权限且首次运行必须申请
从 Android 8（API 26）起，plus.runtime.install() 直接安装 APK 会失败，报错 INSTALL_FAILED_USER_RESTRICTED，除非用户手动开启「允许来自此来源的应用」——这违背静默目标。
必须提前配置并申请：
- 在
manifest.json → 模块配置 → Native.js 权限配置中勾选REQUEST_INSTALL_PACKAGES - 首次安装前调用
plus.android.requestPermissions(['android.permission.REQUEST_INSTALL_PACKAGES']) - 下载路径推荐用
_doc/update.apk，避免写入外部存储被系统拦截 - 若权限未授予，应引导用户去系统设置页手动开启，而不是卡死或静默失败
wgt 热更新和整包更新的兼容性边界必须明确
wgt 方式只适用于资源层变更，以下情况无法热更新，必须走整包：
- SDK 模块增删（如新增 Maps、Bluetooth 模块）
- 原生插件变动（哪怕只是版本号升级）
- 编译模式切换（比如老项目从非自定义组件模式升级到自定义组件模式）
- 新增
nvue文件但原包未内置 Weex 引擎（仅自定义组件模式默认包含）
服务端接口需区分返回类型字段，例如：
<pre class="brush:php;toolbar:false;">{
"updateType": "wgt", // 或 "apk"
"url": "https://xxx/1.2.3.wgt",
"version": "1.2.3"
}
客户端根据 updateType 分支处理，避免用 wgt 方式强行覆盖不兼容的变更。
真正容易被忽略的是：wgt 包本身也有版本兼容性要求——它只能向下兼容同 major 版本的基座（即 manifest.json 中的 versionName 主版本号需一致）。跨 major 升级（如 1.x → 2.x）必须整包。
