为什么iOS UIViewController无法以全屏模式运行?
iOS Game模板项目UIViewController无法全屏问题解决方案
问题本质
基于iOS Game模板新建的项目,无论使用Storyboard搭建界面、还是纯代码在运行时创建所有视图层级,都会出现ViewController无法占满全屏、修改状态栏样式配置无响应的问题。该问题的触发根源是Game模板的默认参数配置与iOS13+的系统适配规则存在冲突,和界面的搭建方式没有直接关联。
落地解决步骤
- 调整Info.plist核心配置项
- 新增布尔类型配置
UIRequiresFullScreen,赋值为YES,强制关闭系统分屏多任务适配逻辑,让主窗口直接占满设备全部显示区域 - 新增/修改配置项
UIViewControllerBasedStatusBarAppearance,赋值为NO,避免Game模板自带的状态栏默认读取逻辑拦截自定义的状态栏设置
- 新增布尔类型配置
- 校准UIScene生命周期的窗口初始化流程
自iOS13起项目默认走UIScene生命周期,Game模板默认的窗口创建流程缺失必要的全屏约束,纯代码搭建界面时需要在Scene代理的连接回调中补充对应配置:func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { guard let windowScene = scene as? UIWindowScene else { return } window = UIWindow(windowScene: windowScene) let rootVC = YourCustomViewController() // 强制指定根控制器的全屏展示风格 rootVC.modalPresentationStyle = .fullScreen // 取消控制器默认的安全区域缩进约束 rootVC.edgesForExtendedLayout = .all rootVC.extendedLayoutIncludesOpaqueBars = true window?.rootViewController = rootVC window?.makeKeyAndVisible() } - 排除Metal渲染层的尺寸干扰
Game模板默认初始化Metal渲染视图作为底层根视图,该层级会自动匹配安全区域边界,直接覆盖上层ViewController的尺寸约束:- 不需要使用Metal渲染能力的项目,直接删除模板自带的MetalView初始化、Metal渲染循环相关代码
- 需要保留Metal渲染能力的项目,手动将MetalView的frame设置为匹配屏幕全尺寸,关闭其自动跟随安全区域调整尺寸的约束
- 补全状态栏自定义配置
完成前面所有配置后,对应ViewController中实现的状态栏配置方法才会被系统正确读取:override var prefersStatusBarHidden: Bool { return true } override var preferredStatusBarStyle: UIStatusBarStyle { return .lightContent }
内容的提问来源于stack exchange,提问作者Viacheslav
相关产品推荐
相关产品推荐

