m***@meiya.com
m***@meiya.com
  • 发布:2025-12-09 10:49
  • 更新:2025-12-10 18:37
  • 阅读:44

【报Bug】uniapp ios整包更新启动异常

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Windows

PC开发环境操作系统版本号: window 11 25H2

HBuilderX类型: 正式

HBuilderX版本号: 4.85

手机系统: iOS

手机系统版本号: iOS 26

手机厂商: 苹果

手机机型: Iphone 16 17

页面类型: vue

vue版本: vue2

打包方式: 云端

项目创建方式: HBuilderX

操作步骤:

现在有一个用依赖包版本号: 2.0.2-4070620250821001的整包,已安装。版本号4.5.70。
随后用依赖包版本号: 2.0.2-4080520251106001的云打包的整包,版本号4.5.71,已上架到App Store。
然后启动手机上的app,再去App Store点更新,更新完重启之后卡在启动界面,退出后台重启依旧卡在启动界面。
最后卸载重装才启动正常。

预期结果:

app整包更新启动正常。

实际结果:

app整包更新启动卡在启动页。

bug描述:

iOS系统26.1, 旧版本已热更新过(4.5.71),再从AppStore更新整包(4.5.71),热更后打开会卡在启动页,杀掉后台重新打开也是卡在启动页,卸载后重新到AppStore下载安装才能够正常使用。

旧版安装包依赖包版本号: 2.0.2-4070620250821001
新版安装包依赖包版本号: 2.0.2-4080520251106001

已设置:
"splashscreen" : {
"alwaysShowBeforeRender" : false,
"waiting" : false,
"autoclose" : true,
"delay" : 0
},

2025-12-09 10:49 负责人:DCloud_iOS_XHY 分享
已邀请:
Ask小助手

Ask小助手

该bug反馈内容较为完整,描述了iOS整包更新后启动卡在启动页的问题,提供了版本信息(旧版依赖包2.0.2-4070620250821001,新版2.0.2-4080520251106001)、splashscreen配置、复现步骤及预期/实际结果。分类信息包含HBuilderX 4.85、iOS 26等关键数据,但缺少Xcode版本、具体错误日志等辅助诊断信息。

bug成立可能性高。根据知识库uni-app各环节版本兼容性说明,整包更新时若新旧版本的uniRuntimeVersion不匹配(如旧版4.5.70对应40706系列,新版4.5.71对应40805系列),可能导致启动异常。iOS系统对应用更新有特殊机制,当通过App Store更新整包后,若新包依赖的底层引擎版本与旧版不兼容,会因运行时环境差异卡在启动页。知识库明确指出:"离线sdk是独立于HBuilderX的下载的...如果HBuilderX编译的wgt和离线sdk的版本不匹配,也会弹框报警",整包更新场景同样适用此规则。

建议用户:

  1. 检查manifest.json中"app-plus""compatible""versionName"配置
  2. 参考App平台整包升级检测确保版本兼容性
  3. 尝试在HBuilderX 4.86+版本重新云打包(当前4.85非最新版)
  4. 整包更新前应通过测试版验证新旧版本兼容性,避免直接上架
内容为 AI 生成,仅供参考
DCloud_App_Array

DCloud_App_Array

从现象看有可能是应用资源版本相同导致的问题,建议wgt升级的版本和整包升级的版本不要相同。
建议升级规划好,比如wgt只做小版本的升级更新(如4.5.71升级到4.5.72),整包做打版本的升级(如4.5.71升级到4.6.0)。
这个问题有可能是不同版本编译生成的应用资源存在兼容问题,这样就可能会导致覆盖升级后运行异常。

要回复问题请先登录注册