UIDesignRequiresCompatibility = YES causes a crash on iOS 26 when built with Xcode 27. The key seems to follow the runtime OS, not the build SDK

Hi,

I ran into a behavior of UIDesignRequiresCompatibility that doesn't match how I (and probably others) read the documentation.

Environment

  • Xcode: 27.2
  • Base SDK: iOS 27.2
  • Deployment target: iOS 18
  • Run destination: iOS 26.6 (physical device)

Documentation

The documentation states:

"The system ignores this key when you build for iOS 27 or later, iPadOS 27 or later, Mac Catalyst 27 or later, macOS 27 or later, or tvOS 27 or later."

I read "build for iOS 27" as a build-time condition: once the app is built with the iOS 27 SDK, the key no longer has any effect, whatever OS the app runs on.

What I observed

  1. With UIDesignRequiresCompatibility = YES in Info.plist, I built the app against the iOS 27 SDK and ran it on iOS 26.6. The app crashes at launch.
  2. I removed only that key, did a clean build with the same configuration, and ran on the same iOS 26.6 device. The app runs normally.

So in practice the key is not ignored for an app built for iOS 27. It looks like the decision is made by the OS the app runs on: iOS 27+ ignores the key, but iOS 26 still reads and applies it to a binary linked against the iOS 27 SDK, and that combination crashes.

Questions

  1. What does "build for iOS 27 or later" refer to: the SDK the app is built with, the deployment target, or the OS the app runs on? My deployment target is iOS 18, so the app still runs on iOS 26. If the key is still honored there even when the app is built with the iOS 27 SDK, could the documentation say so explicitly?
  2. Is compatibility mode on iOS 26 for an app linked against the iOS 27 SDK an unsupported combination, and is the crash expected? Should developers simply remove the key when they adopt the iOS 27 SDK and still support iOS 26?

Thanks!