使用新版5.0.4云打包iOS正式版提交苹果审核被拒绝,原因是打开白屏
- 发布:2026-03-19 17:27
- 更新:2026-03-19 17:38
- 阅读:31
产品分类: uniapp/App
PC开发环境操作系统: Windows
PC开发环境操作系统版本号: windows 11 25H2
HBuilderX类型: 正式
HBuilderX版本号: 5.04
手机系统: iOS
手机系统版本号: iOS 26
手机厂商: 苹果
手机机型: iPad Air 11-inch (M3)
页面类型: vue
vue版本: vue3
打包方式: 云端
项目创建方式: HBuilderX
操作步骤:
预期结果:
无
无
实际结果:
使用新版5.0.4云打包iOS正式版提交苹果审核被拒绝,原因是打开白屏
使用新版5.0.4云打包iOS正式版提交苹果审核被拒绝,原因是打开白屏
bug描述:
今天刚更新新的版本,使用新版HBuilderX-5.0.4云打包iOS正式版提交苹果审核被拒绝,原因是打开白屏—见附件,苹果反馈的截图,使用的设备是iPad Air 11-inch (M3) ,系统是iPadOS 26.3.1。麻烦尽快回复一下什么问题,急等待上架
欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。
作为DCloud官方技术支持人员,对该bug反馈进行如下评审:
反馈质量评估:信息不完整,无法有效定位问题
1. 内容完整性检查
严重不足项:
- 代码示例缺失:未提供任何可复现的代码片段或最小示例工程,官方无法通过"云打包"这一简单描述复现白屏问题
- 关键配置缺失:未提供
manifest.json中iOS相关配置(如SDK版本、是否使用原生插件、是否启用原生混淆等) - 日志信息缺失:未提供云打包日志、运行时控制台报错、设备系统日志等关键排错信息
- 复现步骤模糊:仅描述"使用5.0.4云打包",缺少具体操作流程(是否使用自定义基座、是否包含原生插件、打包参数配置等)
需要补充的信息:
- 是uni-app(Vue3)还是uni-app-x项目?
- 本地自定义基座运行是否正常?
- 是否使用了第三方原生插件或uts插件?
- manifest中是否开启了
原生混淆功能? - 白屏是启动即白屏还是运行一段时间后白屏?
- 控制台是否有JavaScript报错或原生层crash日志?
2. 问题关联性分析
根据知识库检索,该问题可能与以下已知情况相关:
iOS 26兼容性问题(高概率):
优先知识库中明确记录:云打包无法适配IOS26
- 当前云打包环境为 XCode 16.1 / iOS SDK 18.1
- iOS 26(iPadOS 26.3.1)引入了新的API变更,如
setNeedsUpdateProperties等 - 若项目中使用了依赖高版本iOS SDK的插件或代码,可能在iOS 26设备上运行时出现异常
历史版本白屏问题(需排除):
- 4.81版本曾引发"云端打包勾选原生混淆后启动白屏"的bug(已在4.87修复),虽然用户使用的是5.04版本,但需确认是否启用了相关混淆配置
3. 初步诊断建议
请用户按以下步骤补充信息:
-
确认基础运行环境
- 在本地使用自定义基座(iOS标准基座)运行是否正常?
- 是否仅在云打包正式版出现白屏?
-
检查iOS 26兼容性
- 是否使用了第三方原生插件(如HXPhotoPicker等)?
- 如有使用插件,请检查插件是否调用了iOS 26新增API
-
提供关键诊断信息
- 云打包时的完整构建日志(查看是否有编译警告或错误)
- 应用启动后的Xcode设备日志(Window > Devices and Simulators > View Device Logs)
- manifest.json中
app-ios节点的完整配置
-
临时解决方案尝试
- 如使用了原生插件且该插件调用了iOS 26新API,建议将插件打包为动态库(framework)而非源码引入,避免云端编译环境限制
- 检查是否开启了"对配置的js/nvue文件进行原生混淆"选项,尝试关闭后重新打包测试
知识库参考:
结论: 该反馈目前无法判定为有效bug,需用户提供上述补充信息后才能进一步分析。建议优先排查iOS 26系统兼容性相关配置。