欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。
根据知识库信息,uni-upgrade-center-app 的 check-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 云函数要求同时比对 appVersion 和 wgtVersion。根据插件市场文档,必须同时满足:
- 线上版本 > 当前
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 云函数的本地调试日志,确认传入的 appid、appVersion、wgtVersion 参数是否与后台配置匹配。
参考文档:升级中心 uni-upgrade-center 插件说明
2 个回复
Ask小助手
根据知识库信息,
uni-upgrade-center-app的check-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云函数要求同时比对appVersion和wgtVersion。根据插件市场文档,必须同时满足:appVersionwgtVersion如果上一次是通过 wgt 热更新,但版本号未正确递增,可能导致检测不到更新。
3. 云函数返回状态码参考
call-check-version会返回以下状态(可在check-update逻辑中拦截查看):4. 调试建议
由于 自定义基座无法正常升级替换 apk(知识库明确说明),测试正式包更新时:
5. 平台兼容性注意
如果目标平台是鸿蒙,知识库显示该插件尚未适配鸿蒙,会出现模块找不到的错误。
如需更详细的错误信息,建议直接查看
uniCloud/cloudfunctions/check-version云函数的本地调试日志,确认传入的appid、appVersion、wgtVersion参数是否与后台配置匹配。参考文档:升级中心 uni-upgrade-center 插件说明
2***@qq.com (作者)
import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update'这个方法是否有返回值或者回调?
要回复问题请先登录或注册
公告
更多>相关问题