更新记录

0.11.1（2026-10-01） 下载此版本

• 修复 vapor 应用升级弹窗背景颜色跟随全局 page 选择器样式，导致显示异常

0.11.0（2026-10-01） 下载此版本

• 重要 依赖 uni-admin 3.0.1
• 新增 支持 uni-app x vapor 应用的 WGT 热更新
• 新增 uni-app x 更新支持缓存资源包
• 新增 CheckUpdateOptions 参数以供测试
• 新增 UpdateManager. onUpdateReady，以供用户 WGT 安装完成后重启前提醒开发者做准备工作
• 新增 更新提醒 modal/toast 策略
• 修复 Android 通知栏下载完成后直接安装无提示

0.10.2（2026-09-03） 下载此版本

• 修复 下载 wgt 时保存文件后缀名错误

平台兼容性

云端兼容性

uni-app(4.35)

uni-app x(4.65)

其他

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

文档

完整的升级中心配置、云函数和管理后台说明请参阅 uni-upgrade-center。

UpdateManager

UpdateManager 统一管理检查更新、打开升级弹窗、安装完成通知、重启生效和失败事件。推荐在应用入口和业务页面复用同一个管理器实例：

import { createUpdateManager } from '@/uni_modules/uni-upgrade-center-app/utils/update-manager'

const updateManager = createUpdateManager()
const result = await updateManager.checkUpdate()
if (result.hasUpdate && result.packageInfo != null) {
  await updateManager.showUpdate(result.packageInfo)
}

showUpdate 不传更新包信息时，会使用最近一次 checkUpdate 返回的更新包。重复调用时，在上一次弹窗打开完成前会复用同一个 Promise，避免重复打开升级页面。

平台约定

• uni-app x 使用 uni.openDialogPage 打开内置升级页，打开失败时会清理临时存储。
• 传统 App 使用 uni.navigateTo 打开升级页，打开失败时同样会清理临时存储。
• HarmonyOS Next 需要传入平台升级组件作为第二个参数：showUpdate(packageInfo, component)。
• cloud:// 下载地址会先解析为临时 URL；解析失败时 showUpdate 会 reject，不会继续打开无效地址。
• Vapor wgt 安装完成后不会自动重启，业务可调用 applyUpdate()，或使用 notifyUpdateReady 的提示策略。

应用生命周期

如果需要支持用户取消重启后在应用切后台时自动生效，请在 App.uvue 中转发应用生命周期：

const updateManager = createUpdateManager()

onAppShow(() => updateManager.handleAppShow())
onAppHide(() => updateManager.handleAppHide())

事件监听

可通过以下方法监听更新状态，并在页面卸载或不再需要时移除监听：

• onCheckForUpdate / offCheckForUpdate
• onUpdateReady / offUpdateReady
• onUpdateFailed / offUpdateFailed

检查更新的测试参数类型为 CheckUpdateOptions，支持注入 appid、appVersion 和 appWgtVersion；正式环境不传参数时会读取当前应用信息。