SwiftUI/iOS中为特定视图强制固定屏幕方向的实现问题咨询

兄弟，我太懂你这种需求了——儿童APP主界面要横屏给孩子展示内容，引导页、设置页又得用竖屏符合常规操作，而且iOS版本一更新，以前搜的老方法就失效，真的头疼！我刚好最近做过类似的需求，给你分享下现在适配iOS15+到iOS17都能用的方案，亲测稳定：

第一步：先搞定全局方向配置 #

先别在项目设置里锁死方向！打开你的项目配置→Deployment Info，把Portrait、Landscape Left、Landscape Right都勾选上（iPad的话也同步勾上对应的）。这一步很关键，因为如果全局只允许部分方向，后面代码强制的时候会被系统直接忽略。

第二步：通过AppDelegate控制全局方向逻辑 #

因为SwiftUI本身对屏幕方向的底层控制有限，我们得借助UIKit的AppDelegate来动态返回当前页面允许的方向：

首先写一个AppDelegate类，再给UIViewController加个扩展，用来找到当前最顶层的视图控制器：

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, supportedInterfaceOrientationsFor window: UIWindow?) -> UIInterfaceOrientationMask {
        // 找到当前显示的最顶层VC
        guard let topVC = window?.rootViewController?.topMostViewController() else {
            return .portrait // 默认返回竖屏
        }
        
        // 如果当前VC遵守了我们定义的方向协议，就用它指定的方向
        if let orientationLockable = topVC as? OrientationLockable {
            return orientationLockable.supportedOrientations
        }
        
        return .portrait
    }
}

// 扩展UIViewController，递归找到最顶层的VC（处理导航、标签页、弹窗等情况）
extension UIViewController {
    func topMostViewController() -> UIViewController {
        // 处理弹出的VC
        if let presented = presentedViewController {
            return presented.topMostViewController()
        }
        // 处理导航控制器
        if let navVC = self as? UINavigationController {
            return navVC.visibleViewController?.topMostViewController() ?? navVC
        }
        // 处理标签页控制器
        if let tabVC = self as? UITabBarController {
            return tabVC.selectedViewController?.topMostViewController() ?? tabVC
        }
        // 处理iOS16+的NavigationStack对应的VC
        if let navStackVC = self as? UINavigationStackViewController {
            return navStackVC.topViewController?.topMostViewController() ?? navStackVC
        }
        return self
    }
}

// 定义一个协议，让需要固定方向的VC遵守
protocol OrientationLockable {
    var supportedOrientations: UIInterfaceOrientationMask { get }
}

然后在你的SwiftUI App结构体里，把这个AppDelegate挂上去：

@main
struct YourKidsApp: App {
    // 关联我们的AppDelegate
    @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
    
    var body: some Scene {
        WindowGroup {
            // 这里放你的根视图，比如引导页
            OnboardingView().hostedInPortrait()
        }
    }
}

第三步：给需要固定方向的视图做专属包装 #

我们写两个UIHostingController的子类，分别对应竖屏和横屏，让它们遵守上面的OrientationLockable协议：

// 竖屏专属HostingController（给引导页、设置页用）
class PortraitHostingController<Content: View>: UIHostingController<Content>, OrientationLockable {
    var supportedOrientations: UIInterfaceOrientationMask {
        // 只允许竖屏
        return .portrait
    }
}

// 横屏专属HostingController（给主界面用）
class LandscapeHostingController<Content: View>: UIHostingController<Content>, OrientationLockable {
    var supportedOrientations: UIInterfaceOrientationMask {
        // 允许左右两个横屏方向
        return .landscapeLeft.union(.landscapeRight)
    }
}

为了在SwiftUI里方便调用，我们给View加个扩展：

extension View {
    // 快速包装成竖屏视图
    func hostedInPortrait() -> some View {
        self.background(
            UIViewControllerRepresentable { _ in
                PortraitHostingController(rootView: self)
            }
        )
    }
    
    // 快速包装成横屏视图
    func hostedInLandscape() -> some View {
        self.background(
            UIViewControllerRepresentable { _ in
                LandscapeHostingController(rootView: self)
            }
        )
    }
}

第四步：切换视图时强制触发方向更新 #

比如从引导页（竖屏）跳转到主界面（横屏）时，在主界面的onAppear里加一行代码，让系统立刻更新方向：

struct MainView: View {
    var body: some View {
        // 你的主界面内容
        Text("儿童主界面 - 横屏")
            .onAppear {
                // 强制系统更新当前屏幕方向
                UIViewController.attemptRotationToDeviceOrientation()
            }
    }
}

最后提几个注意事项 #

• 如果你用的是iOS16+的NavigationStack，确保在跳转的时候，目标视图也用对应的hostedInXXX方法包装，不然导航栈的顶层VC会覆盖你的方向设置。
• 别忘了在Info.plist里同步配置UISupportedInterfaceOrientations和UISupportedInterfaceOrientations~ipad，把所有允许的方向都加上，和项目设置保持一致。
• 测试的时候一定要用真实设备！模拟器的方向切换有时候会有延迟或者bug，真实设备的测试结果才准。

内容来源于stack exchange