Update documentation for iOS 27, macOS 27, and Xcode 27 support - #13872
Update documentation for iOS 27, macOS 27, and Xcode 27 support#13872MuthuGCodes wants to merge 14 commits into
Conversation
|
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 |
|
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 |
There was a problem hiding this comment.
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.
jmagman
left a comment
There was a problem hiding this comment.
Some small comments. @vashworth should also review.
sfshaza2
left a comment
There was a problem hiding this comment.
I have a couple textual recommendations. But, in order to expedite this, I will approve, but don't land until engineering approves.
# Conflicts: # sites/docs/src/content/platform-integration/ios/setup.md
| Beginning with Xcode 27 (iOS 27 SDK), | ||
| Apple mandates the `UIScene` lifecycle for UIKit apps. |
There was a problem hiding this comment.
The "crash on startup" part was important. How about:
| 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
left a comment
There was a problem hiding this comment.
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!
|
Thank you @jmagman. I've made the change. I'll hold off landing this until Monday. Thanks a lot :) |
Description of what this PR is changing or adding, and why:
Updates documentation across
docs.flutter.devto support iOS 27, macOS 27 ("Golden Gate"), and Xcode 27:sites/docs/src/content/reference/supported-platforms.md):15 to 27.Monterey (12) to Golden Gate (27).sites/docs/src/content/release/breaking-changes/uiscenedelegate.md):UISceneand unmigrated UIKit apps fail to launch on startup.sites/docs/src/content/platform-integration/macos/building.md):sites/docs/src/content/platform-integration/ios/setup.md):open -a DeviceHub) and Xcode 26 (open -a Simulator).[Flutter on latest iOS]link definition.sites/docs/src/content/platform-integration/ios/ios-latest.md):default.yml) and landing card (platform-integration/index.md).sites/docs/firebase.json):/release/breaking-changes/uiscene-lifecycle-iosto/release/breaking-changes/uiscenedelegate(resolves 404 from Flutter 3.47 release blog)./platform-integration/ios/ios-latestto/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