更新记录

1.0.0（2026-11-04） 下载此版本

1.0.0

  • 首次发布
  • 支持 checkHotUpdate / installWgt
  • 支持 silent 静默检查、force 强制更新、下载进度、安装后重启
  • 仅 App 端有效，H5/小程序自动跳过

平台兼容性

uni-app(3.8.10)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
√ √ - - √ √ 4.4 12 -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - - -

lbw-wgt-update

轻量 App 端 wgt 热更新 插件。请求 version.json，比对 versionCode，下载 wgt 并安装重启。

仅 App（app-vue / app-nvue） 有效；H5 / 小程序会跳过。

安装

将本插件放入项目 uni_modules/lbw-wgt-update，或从插件市场导入。

快速使用

// App.vue
import { checkHotUpdate } from '@/uni_modules/lbw-wgt-update/js_sdk/index.js'

export default {
  onLaunch() {
    checkHotUpdate({
      url: 'https://你的域名/pda-update/version.json',
      silent: true // 启动检查：无更新不弹 toast
    })
  }
}

手动检查（设置页按钮）：

checkHotUpdate({
  url: 'https://你的域名/pda-update/version.json',
  silent: false
})

version.json 格式

{
  "versionName": "1.0.1",
  "versionCode": 101,
  "wgtUrl": "https://你的域名/pda-update/app-1.0.1.wgt",
  "force": false,
  "note": "更新说明"
}
字段 必填 说明
versionCode 是 整数，大于本地才更新
versionName 是 展示用版本名
wgtUrl 是 wgt 完整下载地址
force 否 true 强制更新，不可取消
note 否 弹窗说明

API

checkHotUpdate(options)

参数 类型 默认 说明
url string - 必填，version.json 地址
silent boolean false true：无更新/失败不 toast
timeout number 10000 请求超时 ms
debug boolean false 打印调试日志
onNoUpdate Function - 已是最新回调
onFail Function - 检查失败回调
beforeInstall Function - 安装前钩子，返回 false 取消安装

installWgt(wgtUrl, options?)

已有 wgt 地址时，直接下载安装。

发版流程（简要）

  1. 修改 manifest.json 的 versionName / versionCode（必须升高）
  2. HBuilderX：发行 → 原生 App-制作应用 wgt 资源包
  3. 上传 wgt，更新服务器 version.json 的 versionCode、wgtUrl
  4. 用户打开 App 自动检查；安装后需重启生效

注意： 改 Android 权限、原生插件、appid、包名、签名时，不能只发 wgt，需重新打 APK。

平台说明

平台 支持
App-Android / App-iOS ✅
H5 / 小程序 ❌（无 plus.runtime）

隐私、权限声明

1. 本插件需要申请的系统权限列表：

网络访问（用于请求 version.json、下载 wgt 更新包）。不申请相机、定位、通讯录等其他权限。 无额外系统权限申请；运行时需使用网络下载更新包（由宿主 App 网络能力完成）。

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

插件本身不采集、不上传用户隐私数据。仅由开发者在业务中配置的 version.json 地址请求版本信息，并从开发者配置的 wgtUrl 下载更新包，用于 App 热更新。服务器地址由接入方自行配置，插件不内置第三方统计或回传地址。

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

许可协议

MIT License

Copyright (c) 2026 lbw-wgt-update

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

评论列表 撰写评论 向官方投诉

暂无用户评论。