UISplitViewController 在 iPad iOS 13 上启动时不会正确折叠

Question

我正在将我的应用程序转换到 iOS 13，并且 UISplitViewController 折叠到详细视图，而不是启动时的主视图 - 仅在 iPad 上。 此外，没有显示后退按钮 - 就好像它是根视图控制器一样。

我的应用程序由一个UISplitViewController组成，它已被子类化，符合UISplitViewControllerDelegate 。 拆分视图包含两个孩子——都是UINavigationControllers ，并嵌入在UITabBarController （子类TabViewController ）

在拆分视图viewDidLoad中，delegate 设置为self ， preferredDisplayMode设置为.allVisible 。

由于某种原因，方法splitViewController(_:collapseSecondary:onto:)没有被调用。

在iPhone和iPad上的iOS 12中，方法splitViewController(_:collapseSecondary:onto:)在启动时在application(didFinishLaunchingWithOptions)和applicationDidBecomeActive之间正确调用。

在iPhone上的iOS 13中，方法splitViewController(_:collapseSecondary:onto:)在启动时被正确调用，位于scene(willConnectTo session:)和sceneWillEnterForeground 。

但是，在iPad上的iOS 13中，如果窗口在启动时具有紧凑的宽度，例如创建为拆分视图的新场景，则根本不会调用splitViewController(_:collapseSecondary:onto:)方法。 只有将窗口扩大到常规宽度，然后再缩小时才会调用该方法。

class SplitViewController: UISplitViewController, UISplitViewControllerDelegate {
override func viewDidLoad() {
        super.viewDidLoad()
        self.delegate = self
        preferredDisplayMode = .allVisible
}

func splitViewController(_ splitViewController: UISplitViewController, collapseSecondary secondaryViewController:UIViewController, onto primaryViewController:UIViewController) -> Bool {
        print("Split view controller function")
        guard let secondaryAsNavController = secondaryViewController as? UINavigationController else { return false }
        guard let topAsDetailController = secondaryAsNavController.topViewController as? DetailViewController else { return false }
        if topAsDetailController.passedEntry == nil {
            return true
        }
        return false
    }
}

class SceneDelegate: UIResponder, UIWindowSceneDelegate {
func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {

        // Setup split controller
        let tabViewController = self.window!.rootViewController as! TabViewController
        let splitViewController = tabViewController.viewControllers![0] as! SplitViewController
        let navigationController = splitViewController.viewControllers[splitViewController.viewControllers.count-1] as! UINavigationController
        navigationController.topViewController!.navigationItem.leftBarButtonItem = splitViewController.displayModeButtonItem
        navigationController.topViewController!.navigationItem.leftBarButtonItem?.tintColor = UIColor(named: "Theme Colour")

        splitViewController.preferredDisplayMode = .allVisible

}

class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        if #available(iOS 13.0, *) {
        } else {
            let tabViewController = self.window!.rootViewController as! TabViewController
            let splitViewController = tabViewController.viewControllers![0] as! SplitViewController
            let navigationController = splitViewController.viewControllers[splitViewController.viewControllers.count-1] as! UINavigationController
            navigationController.topViewController!.navigationItem.leftBarButtonItem = splitViewController.displayModeButtonItem
            navigationController.topViewController!.navigationItem.leftBarButtonItem?.tintColor = UIColor(named: "Theme Colour")

            splitViewController.preferredDisplayMode = .allVisible
        }

        return true
    }

它难倒我为什么在 iPhone 中调用该方法，而不是在 iPad 中！ 我是一名新开发人员，这是我的第一篇文章，如果我的代码没有提供足够的细节或格式不正确，敬请见谅！

Answer 1

出于某种原因，在 iOS 13 上，特别是 iPad 上的紧凑 traitCollections 调用委托以查看它是否应该在 UISplitViewController 上调用 viewDidLoad 之前发生，因此当它进行该调用时，您的委托未设置，并且该方法永远不会被调用。

如果您以编程方式创建 splitViewController，这是一个简单的解决方法，但如果您使用 Storyboards 就不那么容易了。 您可以通过将委托设置为 awakeFromNib() 而不是 viewDidLoad() 来解决此问题

使用原始帖子中的示例，代码示例如下

class SplitViewController: UISplitViewController, UISplitViewControllerDelegate {
    override func awakeFromNib() {
        super.awakeFromNib()
        delegate = self
        preferredDisplayMode = .allVisible
    }

    func splitViewController(_ splitViewController: UISplitViewController, collapseSecondary secondaryViewController:UIViewController, onto primaryViewController:UIViewController) -> Bool {
        return true
    }
}

您还需要确保您在 collapseSecondary 函数中使用的任何逻辑都没有引用尚未填充的变量，因为尚未调用 viewDidLoad。

Answer 2

我有一个 Xcode 项目 - 现在适用于 iOS 13 - 它使用一个标签栏控制器，与五个拆分视图控制器有关系，每个控制器都有自己的主细节（表）视图和控制器。

以前 - iOS 12.x 及更早版本，实际上是在我编写 Objective-C 时 - 我的拆分视图控制器委托是在每个（父）拆分视图控制器的主视图控制器的代码中设置的 - 我在子类中设置了委托UITableViewController的viewDidLoad方法。 这在 iPhone 和 iPad 上成功运行了多年。

例如

class MasterViewController: UITableViewController, UISplitViewControllerDelegate {

    override func viewDidLoad() {
        super.viewDidLoad()
        splitViewController?.preferredDisplayMode = UISplitViewController.DisplayMode.allVisible
        splitViewController?.delegate = self
        ...
    }

    func splitViewController(_ splitViewController: UISplitViewController, collapseSecondary secondaryViewController:UIViewController, onto primaryViewController:UIViewController) -> Bool {
        ...
    }
}

需要明确的是，我没有对标签栏控制器或拆分视图控制器进行子类化。

随着 Xcode 11 和 iOS 13 的发布，主视图控制器中的拆分视图控制器委托方法不再被调用。

需要明确的是，对于 iOS 13，无论设备或模拟器如何，都不会调用splitViewController(_:collapseSecondary:onto:) （使用断点测试），结果行为：

• iPhone - 当应用程序在设备或模拟器上运行时显示详细视图控制器。
• iPad - 当应用程序在设备或模拟器上运行时显示详细视图控制器，没有后退按钮，因此没有明显的机制来“转义”详细视图。 我发现解决此问题的唯一用户解决方法是更改​​设备方向。 之后，拆分视图控制器按预期运行。

我认为这可能与新类SceneDelegate 。

因此，我将自定义 SceneDelegate 类改装到我的测试项目中，然后是我的主要项目中。

我的自定义 SceneDelegate 类运行良好。 我知道这一点是因为我在场景中成功设置了一个window?.tintColor scene(_:willConnectTo:options:)方法。

然而，拆分视图控制器委托的问题仍在继续。

我记录了对 Apple 的反馈，这是他们编辑后的回复……

...问题是您将 UISplitViewController 的委托设置为覆盖viewDidLoad 。 UISplitViewController可能会在任何事情导致其视图被加载之前决定折叠。 当它这样做时，它会检查它的委托，但由于委托仍然为零，因为您还没有设置它，所以您的代码不会被调用。

由于视图是按需加载的，因此viewDidLoad的时间是不可预测的。 一般来说，最好早点设置视图控制器委托之类的东西。 在scene(willConnectTo: session)可能会更好。

这个建议对我帮助很大。

在我的自定义 SceneDelegate 类中，我将以下代码添加到了scene(_:willConnectTo:options:)方法中......

class SceneDelegate: UIResponder, UIWindowSceneDelegate, UISplitViewControllerDelegate {

    var window: UIWindow?

    func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {

        guard let window = window else { return }
        guard let tabBarController = window.rootViewController as? UITabBarController else { return }

        guard let splitViewController = tabBarController.viewControllers?.first as? UISplitViewController else { return }

        splitViewController.delegate = self
        splitViewController.preferredDisplayMode = UISplitViewController.DisplayMode.allVisible
    }

    ...

    func splitViewController(_ splitViewController: UISplitViewController, collapseSecondary secondaryViewController:UIViewController, onto primaryViewController:UIViewController) -> Bool {
        ...
    }

}

这段代码适用于 iPhone 和 iPad，但显然只适用于第一个拆分主细节视图控制器组合。

我更改了代码以尝试为所有五个拆分视图控制器实现这一成功......

    guard let window = window else { return }
    guard let tabBarController = window.rootViewController as? UITabBarController else { return }

    guard let splitViewControllers = tabBarController.viewControllers else { return }

    for controller in splitViewControllers {

        guard let splitViewController = controller as? UISplitViewController else { return }
        splitViewController.delegate = self
        splitViewController.preferredDisplayMode = UISplitViewController.DisplayMode.allVisible
    }

这段代码也有效......几乎......

我对collapseSecondary是否return true的检查基于来自五个详细视图控制器中的每一个的唯一值 - 计算属性。 由于这种独特的检查，在我的自定义SceneDelegate类中似乎很难确定这一点，因此在我的自定义SceneDelegate类中，我改为编写以下代码......

    guard let window = window else { return }
    guard let tabBarController = window.rootViewController as? UITabBarController else { return }

    guard let splitViewControllers = tabBarController.viewControllers else { return }

    for controller in splitViewControllers {

        guard let splitViewController = controller as? UISplitViewController else { return }
        guard let navigationController = splitViewController.viewControllers.first else { return }
        guard let masterViewController = navigationController.children.first else { return }
        splitViewController.delegate = masterViewController as? UISplitViewControllerDelegate
        splitViewController.preferredDisplayMode = UISplitViewController.DisplayMode.allVisible
    }

...然后使每个详细视图控制器符合UISplitViewControllerDelegate 。

例如

class MasterViewController: UITableViewController, UISplitViewControllerDelegate {

    override func viewDidLoad() {
        super.viewDidLoad()
        // the following two calls now in the scene(_:willConnectTo:options:) method...
        // splitViewController?.preferredDisplayMode = UISplitViewController.DisplayMode.allVisible
        // splitViewController?.delegate = self
        ...
    }

    func splitViewController(_ splitViewController: UISplitViewController, collapseSecondary secondaryViewController:UIViewController, onto primaryViewController:UIViewController) -> Bool {
        ...
    }
}

到目前为止一切顺利，五个拆分视图控制器中的每一个都在应用程序启动时折叠了 iPhone 和 iPad 的详细视图。

Answer 3

嗯，我想答案现在应该涵盖iOS14了。

如果发现委托方法没有被调用。

func splitViewController(_ splitViewController: UISplitViewController, collapseSecondary secondaryViewController:UIViewController, onto primaryViewController:UIViewController) -> Bool {
        ...
}

也许您应该考虑使用iOS14的那个。

  @available(iOS 14.0, *)
  func splitViewController(_ svc: UISplitViewController, topColumnForCollapsingToProposedTopColumn proposedTopColumn: UISplitViewController.Column) -> UISplitViewController.Column {
        return .primary
  }

Answer 4

您需要在“SceneDelegate”类的函数“scene”中添加它：

splitViewController.delegate = self

例如：

    class SceneDelegate: UIResponder, UIWindowSceneDelegate {
    func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {

    // Setup split controller
    let tabViewController = self.window!.rootViewController as! TabViewController
    let splitViewController = tabViewController.viewControllers![0] as! SplitViewController
    let navigationController = splitViewController.viewControllers[splitViewController.viewControllers.count-1] as! UINavigationController
    navigationController.topViewController!.navigationItem.leftBarButtonItem = splitViewController.displayModeButtonItem
    navigationController.topViewController!.navigationItem.leftBarButtonItem?.tintColor = UIColor(named: "Theme Colour")

    splitViewController.preferredDisplayMode = .allVisible

    splitViewController.delegate = self//<<<<<<<<add this

    }

Answer 5

override func awakeFromNib() {
      super.awakeFromNib()
      splitViewController?.delegate = self
      splitViewController?.preferredDisplayMode = .allVisible
}

//MARK: Split View Controller Delegate
    func splitViewController(_ splitViewController: UISplitViewController, collapseSecondary secondaryViewController: UIViewController, onto primaryViewController: UIViewController) -> Bool {
        print("splitview collapse method")
        return false
    }

如果您设置：Storyboard -> Split View Controller -> Style -> Unspecified (Discouraged) not Double Column，则在 Simulator iPhone 上的 Xcode 12.4 中启动时调用方法