iOS SDK开发：无AppDelegate权限下锁定特定屏幕方向

核心问题分析 #

1. iOS13+引入UIWindowScene后，直接修改UIDevice.orientation会触发系统报错，必须使用官方推荐的UIWindowScene.requestGeometryUpdate(_:)方法
2. 单纯重写ViewController的旋转属性（shouldAutorotate等）无效，因为系统会优先读取当前窗口场景/应用全局的方向掩码
3. 作为SDK不能修改客户端的AppDelegate/SceneDelegate，必须实现内部自包含的方向控制逻辑

最优实现方案 #

在SDK的B页面ViewController中，通过生命周期钩子+动态修改全局/场景方向掩码的方式，实现进入时锁定竖屏、离开时恢复原方向的效果，无需客户端额外修改代码。

完整代码实现 #

import UIKit

class SDKLockPortraitVC: UIViewController {
    // 保存进入页面之前的系统方向掩码，用于离开时恢复
    private var originalOrientationMask: UIInterfaceOrientationMask = .all
    
    override func viewWillAppear(_ animated: Bool) {
        super.viewWillAppear(animated)
        
        // 保存当前系统允许的方向
        if #available(iOS 13.0, *) {
            guard let windowScene = view.window?.windowScene else { return }
            originalOrientationMask = windowScene.supportedInterfaceOrientations
            // 请求场景更新为竖屏方向
            let geometryPreferences = UIWindowScene.GeometryPreferences.iOS(interfaceOrientations: .portrait)
            windowScene.requestGeometryUpdate(geometryPreferences) { error in
                if let error = error {
                    print("SDK方向锁定失败: \(error.localizedDescription)")
                }
            }
        } else {
            // iOS12及以下直接修改应用全局方向
            originalOrientationMask = UIApplication.shared.supportedInterfaceOrientations(for: view.window)
            UIApplication.shared.setSupportedInterfaceOrientations(.portrait)
        }
        
        // 强制同步设备方向状态
        UIDevice.current.setValue(UIInterfaceOrientation.portrait.rawValue, forKey: "orientation")
    }
    
    override func viewWillDisappear(_ animated: Bool) {
        super.viewWillDisappear(animated)
        
        // 恢复进入前的方向设置
        if #available(iOS 13.0, *) {
            guard let windowScene = view.window?.windowScene else { return }
            let geometryPreferences = UIWindowScene.GeometryPreferences.iOS(interfaceOrientations: originalOrientationMask)
            windowScene.requestGeometryUpdate(geometryPreferences)
        } else {
            UIApplication.shared.setSupportedInterfaceOrientations(originalOrientationMask)
        }
        
        // 重置设备方向状态
        UIDevice.current.setValue(UIInterfaceOrientation.unknown.rawValue, forKey: "orientation")
    }
    
    // 重写VC旋转属性，确保系统优先遵循当前VC的设置
    override open var shouldAutorotate: Bool {
        return false
    }
    
    override open var supportedInterfaceOrientations: UIInterfaceOrientationMask {
        return .portrait
    }
    
    override open var preferredInterfaceOrientationForPresentation: UIInterfaceOrientation {
        return .portrait
    }
}

方案优势 #

1. 无侵入性：无需客户端修改AppDelegate/SceneDelegate，完全由SDK内部处理
2. 无旋转过渡：在viewWillAppear阶段提前锁定方向，系统不会触发设备旋转动画
3. 兼容性强：适配iOS12到iOS16所有版本，兼顾旧版UIApplication和新版UIWindowScene的API
4. 不影响客户端逻辑：离开页面时自动恢复原方向设置，不会干扰客户端其他页面的旋转行为

注意事项 #

• 确保SDK的B页面是通过push或present方式展示，保证viewWillAppear/viewWillDisappear生命周期钩子正常触发
• 若客户端使用多场景（iPad多窗口），windowScene的获取逻辑依然有效，只会影响当前展示SDK页面的场景方向

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