is UIRequiresFullScreen deprecated or not?

The information coming from Apple is very confusing. https://developer.apple.com/documentation/technotes/tn3192-Migrating-your-app-from-the-deprecated-UIRequiresFullScreen-key says two opposite things:

(1) "Starting in iPadOS 26, UIRequiresFullScreen and its associated compatibility mode are deprecated" and you should migrate away.

(2) "Starting in iOS 27 and iPadOS 27, UIRequiresFullScreen no longer opts your app out of resizing on either platform. Instead, the system resizes your app’s scene discretely. This behavior applies when you build your app with the iOS 27 SDK or later and set UIRequiresFullScreen to YES"

The thing is that (2) implies that UIRequiresFullScreen is legal and in fact is supposed to have a well-defined new behavior, "discrete resizing". I have not been able to detect any evidence of this "discrete resizing" and I don't understand what it is. But the important thing is (2) makes it sound legal but (1) makes it sound illegal. What's true?

@mattn Thanks for the question and pointing out the in the tech note as UIRequiresFullScreen is deprecated as it shows in the documentation below:

https://developer.apple.com/documentation/BundleResources/Information-Property-List/UIRequiresFullScreen

iOS will continue to honor the UIRequiresFullScreen key, but your app will still resize when someone opens or closes their iPhone Duo for example in a case I know.

Xcode should be warning about UIRequiresFullScreen and it does in Xcode 27.2 for sure.

I know in the Duo this is how is explained well:
https://developer.apple.com/videos/play/tech-talks/111461/?time=279

I would be more interested to know the reasons you want to use it and where.

Thanks

Albert  WWDR