You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Swift应用启动黑屏问题:移除LaunchScreen.storyboard后的解决方法

解决应用启动黑屏问题的步骤
  • 核对启动屏幕文件的项目配置
    打开项目Target的「General」设置页,在「App Icons and Launch Images」区域,确认「Launch Screen File」的选择和你截图中项目导航里设置的启动屏幕文件一致,必须指向你当前包含启动屏布局的ViewController所在的storyboard,不能是已删除的LaunchScreen.storyboard。
    启动屏幕配置截图

  • 确保storyboard中启动屏布局的有效性
    你添加到ViewController的storyboard里的启动屏布局要满足:

    • 布局约束完整且正确,能适配不同设备屏幕尺寸;
    • 启动屏对应的ViewController不要添加会延迟视图加载的逻辑代码;
    • 视图背景不要设置为纯黑色(除非是设计需求),避免和黑屏混淆。
  • 确认初始视图控制器的正确设置

    • 在storyboard中,确保目标ViewController的「Is Initial View Controller」选项已勾选(右侧属性面板的「ViewController」分类下);
    • 如果启动屏和主界面是同一个ViewController,检查它的view相关代码,确保没有在加载时隐藏视图或设置黑色背景;如果是单独的启动屏ViewController,要保证启动完成后能无阻塞地跳转到主界面。
  • 清理缓存后重新编译
    缓存可能导致配置不生效,执行以下操作:

    • 按Command + Shift + K清理项目;
    • 按Command + Option + Shift + K清理构建文件夹;
    • 删除Xcode的DerivedData文件夹(路径:~/Library/Developer/Xcode/DerivedData);
    • 重启Xcode并重新编译运行项目。
  • 检查Info.plist的启动配置
    打开Info.plist,确认「UILaunchStoryboardName」键的取值是你当前使用的storyboard文件名(不带.storyboard后缀),如果该键不存在,手动添加并设置正确值。

内容的提问来源于stack exchange,提问作者mahesh

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.09 00:25:56