iOS Swift中如何根据接口返回动态启用/禁用横屏方向？

核心思路 #

先在项目设置中保留所有需要的屏幕方向，通过全局变量控制是否允许横屏，再统一重写视图控制器（包括容器控制器）的方向支持方法，根据全局变量动态返回允许的方向。

具体实现步骤 #

1. 定义全局控制变量

创建一个全局配置单例，用来存储是否允许横屏的状态：

class AppOrientationConfig {
    static let shared = AppOrientationConfig()
    private init() {}
    
    // 默认允许横屏，可根据需求调整初始值
    var allowLandscape: Bool = true
}

2. 启动请求后更新控制状态

在App启动时发起请求，根据接口返回的标志位更新全局变量，必要时强制切换到竖屏：

func loadLaunchConfiguration() {
    // 模拟启动接口请求
    NetworkManager.fetchLaunchSettings { result in
        switch result {
        case .success(let settings):
            // 根据接口返回的标志位更新状态
            AppOrientationConfig.shared.allowLandscape = settings.isLandscapeEnabled
            
            // 如果禁用横屏，立即强制切换到竖屏
            if !AppOrientationConfig.shared.allowLandscape {
                self.forcePortraitOrientation()
            }
        case .failure(_):
            // 接口请求失败时的默认处理，比如默认允许横屏
            AppOrientationConfig.shared.allowLandscape = true
        }
    }
}

// 兼容不同iOS版本的强制转屏方法
private func forcePortraitOrientation() {
    if #available(iOS 16.0, *) {
        guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene else { return }
        windowScene.requestGeometryUpdate(.iOS(interfaceOrientations: .portrait)) { error in
            if let error = error {
                print("强制转屏失败: \(error.localizedDescription)")
            }
        }
    } else {
        UIDevice.current.setValue(UIInterfaceOrientation.portrait.rawValue, forKey: "orientation")
    }
}

3. 统一处理视图控制器的方向支持

创建基础视图控制器，所有业务页面继承这个基类，重写方向相关方法：

class BaseViewController: UIViewController {
    override var supportedInterfaceOrientations: UIInterfaceOrientationMask {
        AppOrientationConfig.shared.allowLandscape ? .allButUpsideDown : .portrait
    }
    
    override var shouldAutorotate: Bool {
        true
    }
}

4. 处理容器控制器（导航/标签栏）的方向支持

如果项目中使用了UINavigationController或UITabBarController，需要自定义子类并重写方向方法，让容器控制器遵循当前显示页面的方向规则：

// 自定义导航控制器
class BaseNavigationController: UINavigationController {
    override var supportedInterfaceOrientations: UIInterfaceOrientationMask {
        topViewController?.supportedInterfaceOrientations ?? .portrait
    }
    
    override var shouldAutorotate: Bool {
        true
    }
}

// 自定义标签栏控制器
class BaseTabBarController: UITabBarController {
    override var supportedInterfaceOrientations: UIInterfaceOrientationMask {
        selectedViewController?.supportedInterfaceOrientations ?? .portrait
    }
    
    override var shouldAutorotate: Bool {
        true
    }
}

关键注意事项 #

• 项目设置中必须勾选需要支持的所有方向（竖屏+左右横屏），否则代码层面无法启用横屏。
• 如果启动时需要先保持竖屏直到接口返回，可将AppOrientationConfig的allowLandscape初始值设为false。
• 确保所有页面都继承自BaseViewController，容器控制器使用自定义的子类，避免出现不受控制的页面。

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