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
相关产品推荐
相关产品推荐

