Скачать или смотреть Solving UISplitViewController Issues in iOS 14: Portrait Mode Challenges Explained

Discover how to troubleshoot and solve UISplitViewController challenges in iOS 14, particularly focusing on `portrait mode` issues and enhancing your app's functionality.
---
This video is based on the question https://stackoverflow.com/q/63237929/ asked by the user 'user13138159' ( https://stackoverflow.com/u/13138159/ ) and on the answer https://stackoverflow.com/a/63247626/ provided by the user 'user13138159' ( https://stackoverflow.com/u/13138159/ ) at 'Stack Overflow' website. Thanks to these great users and Stackexchange community for their contributions.

Visit these links for original content and any more details, such as alternate solutions, latest updates/developments on topic, comments, revision history etc. For example, the original title of the Question was: UISplitViewController in iOS 14 works as intended in landscape mode, but not in portrait

Also, Content (except music) licensed under CC BY-SA https://meta.stackexchange.com/help/l...
The original Question post is licensed under the 'CC BY-SA 4.0' ( https://creativecommons.org/licenses/... ) license, and the original Answer post is licensed under the 'CC BY-SA 4.0' ( https://creativecommons.org/licenses/... ) license.

If anything seems off to you, please feel free to write me at vlogize [AT] gmail [DOT] com.
---
Understanding the UISplitViewController Problem in iOS 14

When developing applications for iOS 14, many developers have encountered issues with the UISplitViewController, especially when it comes to how the user interface behaves in portrait mode. In particular, the faithful functionality seen in iOS 13 may not translate correctly. Users may experience problems such as conditional logic failure, where specific view controllers do not appear as intended upon app launch.

The Problem at a Glance

Imagine launching your app with a UISplitViewController as the initial view controller. In landscape mode, everything functions as expected. However, as soon as you switch to portrait mode, you run into a few frustrations:

The primary view controller fails to show based on certain conditions.

Navigation bars and titles that are essential for user navigation are absent.

This issue seems to only manifest on the first launch; switching from landscape to portrait restores the missing elements.

Breakdown of the Challenge

From the provided code snippet, it’s clear that there's an attempt to manage the secondary and primary view controllers through UIKit delegate methods. The custom logic is supposed to determine if the app should collapse the detail view controller back to the primary one based on certain conditions. Here’s the key concern:

[[See Video to Reveal this Text or Code Snippet]]

The current logic only works when the app is first launched in landscape mode, hence the issue in portrait mode.

A Deeper Dive into the Solution

The path to resolving this issue lies in utilizing the new delegate method introduced with iOS 14: topColumnForCollapsingToProposedTopColumn. This allows developers to have more granular control over how the split view controller behaves based on the preferred interface orientation.

Steps to Implement the Solution

Implement the Delegate Method:
Start by adding the new delegate method to your UISplitViewController delegate:

[[See Video to Reveal this Text or Code Snippet]]

Return the Correct Column:
Based on the conditions needed for your app, adjust the return value between .primary and .secondary. This method provides a straightforward way to manage which view should be presented when transitioning from the secondary view controller in portrait mode.

Additional Considerations

Testing for Edge Cases:
Ensure thorough testing in both orientations and pay special attention to the first launch scenarios. Edge cases often create unexpected behavior, and verifying with devices that have different screen sizes can help capture a wider range of user experiences.

User Interface Consistency:
Maintain navigation consistency between modes. Utilizing large titles and bar button items is a best practice that enhances user experience, so ensure they are correctly displayed regardless of orientation.

Conclusion

The transition from iOS 13 to iOS 14 has brought both enhancements and challenges for developers working with UISplitViewController. By leveraging the new delegate methods and understanding the behavior of view controllers in different orientations, you can effectively troubleshoot and enhance your app’s usability in portrait mode. Armed with this knowledge, you’ll be able to provide a seamless experience for your users on iOS 14 and beyond.