2***@qq.com
2***@qq.com
  • 发布:2026-04-28 09:55
  • 更新:2026-04-28 11:16
  • 阅读:20

uni-upgrade-center正式包不弹更新

分类:uni-app

打自定义基座调试可以正常弹,正式包就是不弹,啥情况,import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update'这个方法是否有返回值或者回调,可以看到报错信息吗?

2026-04-28 09:55 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

根据知识库信息,uni-upgrade-center-appcheck-update 方法在正式包中不弹更新通常与 AppID 不匹配版本检测逻辑 有关。以下是排查方向:

常见原因及解决方案

1. 检查 AppID 配置

在调试时(自定义基座),plus.runtime.appid 返回的是固定值 HBuilder,而正式包使用的是 manifest.json 中配置的真实 AppID。

如果云函数 check-version 返回 code: -101(暂无更新或检查appid是否填写正确),说明正式包的 AppID 未在 uni-admin 后台的升级中心正确配置或数据库中无对应版本记录。

验证方式:查看云函数 check-version 的返回结果,确认是否返回 -101 错误。

2. 版本号对比逻辑

check-version 云函数要求同时比对 appVersionwgtVersion。根据插件市场文档,必须同时满足:

  • 线上版本 > 当前 appVersion
  • 线上版本 > 当前 wgtVersion

如果上一次是通过 wgt 热更新,但版本号未正确递增,可能导致检测不到更新。

3. 云函数返回状态码参考

call-check-version 会返回以下状态(可在 check-update 逻辑中拦截查看):

code 含义 说明
0 无需更新 当前已是最新版本
101 wgt 更新 需要热更新
102 整包更新 需要下载安装包
-101 参数错误 暂无更新或检查 appid 是否填写正确
-102 传参错误 请检查 appid/appVersion/wgtVersion 是否填写

4. 调试建议

由于 自定义基座无法正常升级替换 apk(知识库明确说明),测试正式包更新时:

  • 必须使用云端打包生成的正式包(非自定义基座)进行测试
  • 确保 uni-admin 后台已发布对应平台的线上版本,且状态为"上线发行"

5. 平台兼容性注意

如果目标平台是鸿蒙,知识库显示该插件尚未适配鸿蒙,会出现模块找不到的错误。

如需更详细的错误信息,建议直接查看 uniCloud/cloudfunctions/check-version 云函数的本地调试日志,确认传入的 appidappVersionwgtVersion 参数是否与后台配置匹配。

参考文档:升级中心 uni-upgrade-center 插件说明

内容为 AI 生成,仅供参考
2***@qq.com

2***@qq.com (作者)

import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update'这个方法是否有返回值或者回调?

要回复问题请先登录注册