如何修复通用App在iPhone端启动默认显示Detail而非Master的问题

嘿，这个问题我之前在开发通用App时也踩过坑！SplitViewController在iPhone（紧凑宽度环境）和iPad（常规宽度环境）的默认行为有差异，要让iPhone启动时默认展示MasterViewController且不影响iPad的逻辑，你可以按照下面的方法来处理：

方法一：利用SplitViewController的Delegate方法（推荐） #

这是最可靠的方式，能精准控制不同设备的折叠行为：

1. 让容器ViewController遵守UISplitViewControllerDelegate协议
   比如你处理embedseg segue的那个ViewController，先添加协议声明：

   class YourContainerVC: UIViewController, UISplitViewControllerDelegate {
       // ... 你的现有代码
   }
   

2. 在prepare方法中设置Delegate
   在你拿到splitViewController的代码块里，添加代理设置：

   override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
       if segue.identifier == "embedseg" {
           guard let splitViewController = segue.destination as? UISplitViewController,
                 let leftNavController = splitViewController.viewControllers.first as? UINavigationController,
                 let masterViewController = leftNavController.topViewController as? MasterViewController else {
               return
           }
           
           // 设置SplitViewController的代理为当前VC
           splitViewController.delegate = self
           // ... 你其他的初始化逻辑
       }
   }
   

3. 实现折叠控制的Delegate方法
   添加下面的方法，让iPhone环境下默认保留Master作为初始显示页面：

   func splitViewController(_ splitViewController: UISplitViewController, collapseSecondary secondaryViewController: UIViewController, onto primaryViewController: UIViewController) -> Bool {
       // 仅在iPhone（紧凑宽度设备）下返回true，阻止Secondary（Detail）折叠覆盖Primary（Master）
       return UIDevice.current.userInterfaceIdiom == .phone
   }
   

方法二：直接设置SplitViewController的显示模式 #

如果Delegate方法不满足你的需求，也可以直接针对iPhone设置显示模式：
在prepare方法中拿到splitViewController后，添加以下代码：

if UIDevice.current.userInterfaceIdiom == .phone {
    // 设置默认显示Master，同时允许用户切换到Detail
    splitViewController.preferredDisplayMode = .primaryOverlay
    // 强制初始展示Master页面
    splitViewController.show(primaryViewController: leftNavController, sender: self)
}

额外检查点 #

• 确保Storyboard中，SplitViewController的第一个子ViewController是Master所在的NavigationController，第二个是Detail的NavigationController，顺序不能搞反。
• 如果你的DetailViewController启动时没有默认数据，系统可能会自动优先展示Master，但如果有默认数据，就需要上面的方法强制控制显示逻辑。

这样处理后，iPad端会保持原来的分屏逻辑（同时显示Master和Detail），而iPhone端启动时会默认展示MasterViewController，完美适配两端！

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