Skip to content

Update documentation for iOS 27, macOS 27, and Xcode 27 support - #13872

Draft
MuthuGCodes wants to merge 14 commits into
flutter:mainfrom
MuthuGCodes:ios-27-flutter-updates
Draft

Update documentation for iOS 27, macOS 27, and Xcode 27 support#13872
MuthuGCodes wants to merge 14 commits into
flutter:mainfrom
MuthuGCodes:ios-27-flutter-updates

Conversation

@MuthuGCodes

@MuthuGCodes MuthuGCodes commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Description of what this PR is changing or adding, and why:

Updates documentation across docs.flutter.dev to support iOS 27, macOS 27 ("Golden Gate"), and Xcode 27:

  • Supported platforms (sites/docs/src/content/reference/supported-platforms.md):
    • Update iOS supported version range to 15 to 27.
    • Update macOS supported version range to Monterey (12) to Golden Gate (27).
  • UIScene migration guide (sites/docs/src/content/release/breaking-changes/uiscenedelegate.md):
    • Add a version note documenting that Xcode 27 (iOS 27 SDK) mandates UIScene and unmigrated UIKit apps fail to launch on startup.
    • Update the timeline section to reflect enforcement in Xcode 27.
  • macOS building (sites/docs/src/content/platform-integration/macos/building.md):
    • Add an informational warning note regarding the ongoing deprecation of macOS Intel (x64) hardware, linking to the deprecation strategy.
  • iOS setup (sites/docs/src/content/platform-integration/ios/setup.md):
    • Provide launch commands for both Xcode 27+ (open -a DeviceHub) and Xcode 26 (open -a Simulator).
    • Refine simulator recommendation phrasing per style guide and remove unused [Flutter on latest iOS] link definition.
  • Retire outdated iOS latest tracker (sites/docs/src/content/platform-integration/ios/ios-latest.md):
    • Remove outdated feature tracking page.
    • Remove corresponding entry from sidenav (default.yml) and landing card (platform-integration/index.md).
  • Hosting redirects (sites/docs/firebase.json):
    • Add 301 redirect from /release/breaking-changes/uiscene-lifecycle-ios to /release/breaking-changes/uiscenedelegate (resolves 404 from Flutter 3.47 release blog).
    • Add 301 redirect from /platform-integration/ios/ios-latest to /platform-integration/ios (gracefully handling existing references including past release notes).

Issues fixed by this PR (if any):
b/540919760

PRs or commits this PR depends on (if any):
None

Presubmit checklist

  • If you are unwilling, or unable, to sign the CLA, even for a tiny, one-word PR, please file an issue instead of a PR.
  • If this PR is not meant to land until a future stable release, mark it as draft with an explanation.
  • This PR follows the Google Developer Documentation Style Guidelines—for example, it doesn't use i.e. or e.g., and it avoids I and we (first-person pronouns).
  • This PR uses semantic line breaks of 80 characters or fewer.

@flutter-website-bot

flutter-website-bot commented Sep 10, 2026

Copy link
Copy Markdown
Collaborator

Staged preview of the updated docs.flutter.dev site (updated for commit 1f322b3):

https://flutter-docs-prod--docs-pr13872-ios-27-flutter-updates-1cbocxcw.web.app

@flutter-website-bot

flutter-website-bot commented Sep 10, 2026

Copy link
Copy Markdown
Collaborator

Staged preview of the updated flutter.dev site (updated for commit 1f322b3):

https://flutter-dev-230821--www-pr13872-ios-27-flutter-updates-kv8qww1t.web.app

@MuthuGCodes MuthuGCodes self-assigned this Sep 10, 2026
@MuthuGCodes
MuthuGCodes marked this pull request as ready for review September 10, 2026 13:27
@MuthuGCodes
MuthuGCodes requested review from a team and sfshaza2 as code owners September 10, 2026 13:27

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the documentation to support iOS 27 and macOS 27 (Golden Gate). Key changes include updating supported platform versions, adding a warning regarding macOS Intel (x64) deprecation, documenting the mandatory UIScene lifecycle starting with Xcode 27, and removing the obsolete "Flutter on latest iOS" page in favor of redirects. Feedback was provided to reword a sentence in the iOS setup guide to avoid using the first-person pronoun "we", aligning with the style guidelines.

Comment thread sites/docs/src/content/platform-integration/ios/setup.md Outdated

@jmagman jmagman left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some small comments. @vashworth should also review.

Comment thread sites/docs/src/content/platform-integration/macos/building.md Outdated
Comment thread sites/docs/src/content/reference/supported-platforms.md Outdated

@sfshaza2 sfshaza2 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have a couple textual recommendations. But, in order to expedite this, I will approve, but don't land until engineering approves.

Comment thread sites/docs/src/content/platform-integration/ios/setup.md Outdated
Comment thread sites/docs/src/content/platform-integration/ios/setup.md Outdated
@MuthuGCodes

Copy link
Copy Markdown
Contributor Author

Thanks a lot, @jmagman, @sfshaza2. I've incorporated the changes.

Comment on lines +1102 to +1103
Beginning with Xcode 27 (iOS 27 SDK),
Apple mandates the `UIScene` lifecycle for UIKit apps.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The "crash on startup" part was important. How about:

Suggested change
Beginning with Xcode 27 (iOS 27 SDK),
Apple mandates the `UIScene` lifecycle for UIKit apps.
Flutter apps that haven't adopted the `UIScene` lifecycle
will crash on startup when built with Xcode 27 (iOS 27 SDK).

@jmagman jmagman left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This LGTM with the one nit about leaving in the "crash on startup" note.

Please hold off landing this until Monday when iOS 27 will be released.

Thank you!

@MuthuGCodes

Copy link
Copy Markdown
Contributor Author

Thank you @jmagman. I've made the change.

I'll hold off landing this until Monday. Thanks a lot :)

@MuthuGCodes
MuthuGCodes marked this pull request as draft September 10, 2026 20:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants