-
Notifications
You must be signed in to change notification settings - Fork 3.3k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add iOS 18.4 beta warnings #11740
Add iOS 18.4 beta warnings #11740
Conversation
Visit the preview URL for this PR (updated for commit 4f514c3): https://flutter-docs-prod--pr11740-ios-18-4-warning-45b6gmsm.web.app |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Content LGTM, tech writer should approve and wordsmith as needed though.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM with a tiny suggestion for wording.
:::warning | ||
Flutter's debug mode is broken on physical devices running iOS 18.4 beta. | ||
See [flutter#163984][] for details. | ||
|
||
Flutter recommends you do not upgrade your devices to iOS 18.4 beta. | ||
|
||
To target iOS 18.4 beta physical devices, use | ||
[Flutter's release or profile build modes][]. | ||
|
||
Alternatively, target an iOS simulator or iOS 18.3 or lower physical device. | ||
::: | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
WDYT of:
An upcoming change to iOS has caused a temporary break in Flutter's ability to debug code on physical devices running iOS 18.4 (currently in beta). See [flutter#163984][] for details.
In the meantime, we recommend these workarounds:
- When developing with a physical device, use one running iOS 18.3 or earlier.
- Use a simulator for development rather than a physical device.
- If you must use a device updated to iOS 18.4, use [Flutter's release or profile build modes][] to do so.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Updated with some minor tweaks!
14eb194
to
1b95daa
Compare
I'll go ahead and merge this since this is a higher priority update. |
This reverts commit 8615c47.
See [Flutter on latest iOS][] for details. | ||
::: | ||
|
||
[Flutter on latest iOS]: {{site.github}}/ios/ios-latest |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This link seems to be wrong — it ends up pointing to https://github.com/ios/ios-latest .
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for catching this, opened: #11752
iOS 18.4 beta breaks Flutter's debug mode on physical devices. Until we hotfix this issue, users should not upgrade to iOS 18.4 beta. Users that have upgraded their device to iOS 18.4 beta should run their apps in release or profile modes, or, target an iOS simulator instead.
This PR will be reverted once the issue is hotfixed.
Part of flutter/flutter#163984
Screenshots
https://flutter-docs-prod--pr11740-ios-18-4-warning-45b6gmsm.web.app/get-started/install/macos/mobile-ios#configure-your-target-ios-device
https://flutter-docs-prod--pr11740-ios-18-4-warning-45b6gmsm.web.app/platform-integration/ios/ios-latest
Presubmit checklist