9***@qq.com
9***@qq.com
  • 发布:2026-03-19 17:27
  • 更新:2026-03-19 17:38
  • 阅读:31

【报Bug苹果打包正式版白屏

分类:uni-app

产品分类: 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。麻烦尽快回复一下什么问题,急等待上架

2026-03-19 17:27 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

欢迎到专业群( 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. 初步诊断建议

请用户按以下步骤补充信息:

  1. 确认基础运行环境

    • 在本地使用自定义基座(iOS标准基座)运行是否正常?
    • 是否仅在云打包正式版出现白屏?
  2. 检查iOS 26兼容性

    • 是否使用了第三方原生插件(如HXPhotoPicker等)?
    • 如有使用插件,请检查插件是否调用了iOS 26新增API
  3. 提供关键诊断信息

    • 云打包时的完整构建日志(查看是否有编译警告或错误)
    • 应用启动后的Xcode设备日志(Window > Devices and Simulators > View Device Logs)
    • manifest.json中app-ios节点的完整配置
  4. 临时解决方案尝试

    • 如使用了原生插件且该插件调用了iOS 26新API,建议将插件打包为动态库(framework)而非源码引入,避免云端编译环境限制
    • 检查是否开启了"对配置的js/nvue文件进行原生混淆"选项,尝试关闭后重新打包测试

知识库参考:

结论: 该反馈目前无法判定为有效bug,需用户提供上述补充信息后才能进一步分析。建议优先排查iOS 26系统兼容性相关配置。

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

9***@qq.com (作者) - uniapp前端开发

1、未使用原生混淆
2、自定义基座在ios26系统下运行是没问题的,云打包正式版后启动就白屏,只显示tabBar
3、使用了uts插件

要回复问题请先登录注册