iOS 17 iPad端强制屏幕旋转失效，寻求解决方案

报错核心原因 #

你遇到的UISceneErrorDomain Code=101错误，本质是iPad当前窗口模式不支持程序强制旋转——当应用处于分屏、Slide Over或悬浮窗口状态时，iOS会禁止代码主动修改界面方向。此外，应用方向配置、UISplitViewController的方向管理逻辑也可能引发该问题。

解决步骤 #

1. 确保应用处于全屏模式 #

iPad仅允许全屏运行的应用通过代码强制旋转屏幕，可在旋转前判断窗口状态：

// iOS16+ 检查窗口是否支持旋转操作
if #available(iOS 16.0, *) {
    guard windowScene.windowingEnvironment.supportsGeometryUpdates else {
        print("请将应用切换到全屏模式后重试")
        return
    }
}

2. 配置应用方向支持 #

• 在Info.plist中找到UISupportedInterfaceOrientations~ipad，添加需要的方向（如UIInterfaceOrientationLandscapeLeft、UIInterfaceOrientationPortrait）。
• 在你的UISplitViewController或当前ViewController中重写方向支持方法：

override var supportedInterfaceOrientations: UIInterfaceOrientationMask {
    // 根据需求返回允许的方向，示例为除倒转外的所有方向
    return .allButUpsideDown
}

3. 修正旋转逻辑代码 #

替换原有旋转方法，确保获取正确的窗口场景，并适配SplitViewController特性：

@IBAction func btnSelector(_ sender: Any) {
    rotateToLandscapeDevice()
}

func rotateToLandscapeDevice(){
    // 获取当前ViewController所在窗口的WindowScene（比全局取第一个更准确）
    guard let windowScene = view.window?.windowScene else {
        print("无法获取有效窗口场景")
        return
    }
    
    if #available(iOS 16.0, *) {
        guard windowScene.windowingEnvironment.supportsGeometryUpdates else {
            print("当前窗口模式不支持旋转，请切换到全屏")
            return
        }
        
        windowScene.requestGeometryUpdate(.iOS(interfaceOrientations: .landscapeLeft)) { error in
            if let error = error {
                print("旋转失败: \(error.localizedDescription)")
            }
        }
        self.setNeedsUpdateOfSupportedInterfaceOrientations()
    } else {
        // iOS15及以下版本处理
        UIDevice.current.setValue(UIInterfaceOrientation.landscapeLeft.rawValue, forKey: "orientation")
        // 强制触发系统旋转逻辑
        UIViewController.attemptRotationToDeviceOrientation()
    }
}

4. 额外注意事项 #

• 确保设备未开启屏幕旋转锁定，否则代码无法触发旋转。
• 若使用UISplitViewController，可设置默认展示方向：

override var preferredInterfaceOrientationForPresentation: UIInterfaceOrientation {
    return .landscapeLeft
}

内容的提问来源于stack exchange，提问作者krunal