Update Docs to Warn Users Edge-To-Edge opt out is being deprecated for Android 16+ (API 36+) #170816

jesswrd · 2025-06-18T16:59:11Z

Documenting that starting Android 16 (API 36) there will be no way to opt out of Edge to Edge mode, which was added in Android 15 (API 35) with a way to opt out.

Fixes #165329

Partially Addresses #169746, #169251, #163545, #165329

Pre-launch Checklist

I read the Contributor Guide and followed the process outlined there for submitting PRs.
I read the Tree Hygiene wiki page, which explains my responsibilities.
I read and followed the Flutter Style Guide, including Features we expect every widget to implement.
I signed the CLA.
I listed at least one issue that this PR fixes in the description above.
I updated/added relevant documentation (doc comments with ///).
I added new tests to check the change I am making, or this PR is test-exempt.
I followed the breaking change policy and added Data Driven Fixes where supported.
All existing and new tests are passing.

If you need help, consider asking for advice on the #hackers-new channel on Discord.

camsim99

LGTM % nits :)

Also, I think we need to update https://docs.flutter.dev/release/breaking-changes/default-systemuimode-edge-to-edge slightly as well, but I'm happy to take that on if you have other stuff goin on!

camsim99 · 2025-06-18T18:11:23Z

engine/src/flutter/shell/platform/android/io/flutter/plugin/platform/PlatformPlugin.java

      // instructions found in
      // https://docs.flutter.dev/release/breaking-changes/default-systemuimode-edge-to-edge.
      //
+      // If the Flutter Android app targets Android SDK 16 (API 36), then the Android


Nit:

Suggested change

// If the Flutter Android app targets Android SDK 16 (API 36), then the Android

// If the Flutter Android app targets Android SDK 16 (API 36) or later, then the Android

camsim99 · 2025-06-18T18:11:33Z

packages/flutter/lib/src/services/system_chrome.dart

+  /// instructions found in
+  /// https://docs.flutter.dev/release/breaking-changes/default-systemuimode-edge-to-edge.
+  ///
+  /// If your app targets Android SDK 16 (API 36) and later, then your Flutter app uses [SystemUiMode.edgeToEdge] by default


Nit:

Suggested change

/// If your app targets Android SDK 16 (API 36) and later, then your Flutter app uses [SystemUiMode.edgeToEdge] by default

/// If your app targets Android SDK 16 (API 36) or later, then your Flutter app uses [SystemUiMode.edgeToEdge] by default

…into systemUiOverlay-cleanup

camsim99

LGTM :)

camsim99 · 2025-06-18T20:18:07Z

engine/src/flutter/shell/platform/android/io/flutter/plugin/platform/PlatformPlugin.java

      // Available starting at Android SDK 4.4 (API 19).
      //
-      // If the Flutter Android app targets Android SDK 15 (API 35) or later then the Android
+      // If the Flutter Android app targets Android SDK 15 (API 35) then the Android


Really nit

Suggested change

// If the Flutter Android app targets Android SDK 15 (API 35) then the Android

// If the Flutter Android app targets Android SDK 15 (API 35), then the Android

…cated for Android 16+ (API 36+) (flutter/flutter#170816)

flutter/flutter@0ab008a...d733bea 2025-06-23 mdebbar@google.com Add `--no-web-resources-cdn` to all web integration tests (flutter/flutter#171013) 2025-06-23 bkonyi@google.com [ Tool ] Roll package:dds 5.0.4 (flutter/flutter#171007) 2025-06-23 jessiewong401@gmail.com Update Docs to Warn Users Edge-To-Edge opt out is being deprecated for Android 16+ (API 36+) (flutter/flutter#170816) 2025-06-23 30870216+gaaclarke@users.noreply.github.com License cpp jun20 (flutter/flutter#170948) 2025-06-23 mdebbar@google.com Un-bringup `Linux web_tool_tests` (flutter/flutter#171004) 2025-06-23 engine-flutter-autoroll@skia.org Roll Packages from 7f41e75 to 02770da (5 revisions) (flutter/flutter#171006) 2025-06-23 engine-flutter-autoroll@skia.org Roll Dart SDK from bb16990911b5 to a09de0d3556c (2 revisions) (flutter/flutter#171000) 2025-06-23 bruno.leroux@gmail.com Reland: Fix InputDecoration.floatingLabelBehavior is not inherited (flutter/flutter#170995) 2025-06-23 engine-flutter-autoroll@skia.org Roll Skia from aef4081157f0 to 0311837abe86 (1 revision) (flutter/flutter#170992) 2025-06-23 sigurdm@google.com Run pub get post-processing for each package in workspace (flutter/flutter#170517) 2025-06-23 98614782+auto-submit[bot]@users.noreply.github.com Reverts "Fix InputDecoration.floatingLabelBehavior is not inherited (#170905)" (flutter/flutter#170994) 2025-06-23 bruno.leroux@gmail.com Fix InputDecoration.floatingLabelBehavior is not inherited (flutter/flutter#170905) 2025-06-23 engine-flutter-autoroll@skia.org Roll Skia from fcd1c55da9cc to aef4081157f0 (1 revision) (flutter/flutter#170990) 2025-06-22 robert.ancell@canonical.com Clear background in the GTK layer, instead of OpenGL (flutter/flutter#170840) 2025-06-22 robert.ancell@canonical.com Show window on first frame on Linux (flutter/flutter#170844) 2025-06-22 engine-flutter-autoroll@skia.org Roll Dart SDK from 98db1db5ff65 to bb16990911b5 (1 revision) (flutter/flutter#170988) If this roll has caused a breakage, revert this CL and stop the roller using the controls here: https://autoroll.skia.org/r/flutter-packages Please CC muhatashim@google.com,stuartmorgan@google.com on the revert to ensure that a human is aware of the problem. To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose To report a problem with the AutoRoller itself, please file a bug: https://issues.skia.org/issues/new?component=1389291&template=1850622 Documentation for the AutoRoller is here: https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md

…r Android 16+ (API 36+) (flutter#170816) Documenting that starting Android 16 (API 36) there will be no way to opt out of Edge to Edge mode, which was added in Android 15 (API 35) with a way to opt out. Fixes flutter#165329 Partially Addresses flutter#169746, flutter#169251, flutter#163545, flutter#165329 ## Pre-launch Checklist - [x] I read the [Contributor Guide] and followed the process outlined there for submitting PRs. - [x] I read the [Tree Hygiene] wiki page, which explains my responsibilities. - [x] I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement]. - [x] I signed the [CLA]. - [x] I listed at least one issue that this PR fixes in the description above. - [x] I updated/added relevant documentation (doc comments with `///`). - [x] I added new tests to check the change I am making, or this PR is [test-exempt]. - [x] I followed the [breaking change policy] and added [Data Driven Fixes] where supported. - [ ] All existing and new tests are passing. If you need help, consider asking for advice on the #hackers-new channel on [Discord].  [Contributor Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview [Tree Hygiene]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md [test-exempt]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests [Flutter Style Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md [Features we expect every widget to implement]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement [CLA]: https://cla.developers.google.com/ [flutter/tests]: https://github.com/flutter/tests [breaking change policy]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes [Discord]: https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md [Data Driven Fixes]: https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md

flutter/flutter@0ab008a...d733bea 2025-06-23 mdebbar@google.com Add `--no-web-resources-cdn` to all web integration tests (flutter/flutter#171013) 2025-06-23 bkonyi@google.com [ Tool ] Roll package:dds 5.0.4 (flutter/flutter#171007) 2025-06-23 jessiewong401@gmail.com Update Docs to Warn Users Edge-To-Edge opt out is being deprecated for Android 16+ (API 36+) (flutter/flutter#170816) 2025-06-23 30870216+gaaclarke@users.noreply.github.com License cpp jun20 (flutter/flutter#170948) 2025-06-23 mdebbar@google.com Un-bringup `Linux web_tool_tests` (flutter/flutter#171004) 2025-06-23 engine-flutter-autoroll@skia.org Roll Packages from 7f41e75 to 02770da (5 revisions) (flutter/flutter#171006) 2025-06-23 engine-flutter-autoroll@skia.org Roll Dart SDK from bb16990911b5 to a09de0d3556c (2 revisions) (flutter/flutter#171000) 2025-06-23 bruno.leroux@gmail.com Reland: Fix InputDecoration.floatingLabelBehavior is not inherited (flutter/flutter#170995) 2025-06-23 engine-flutter-autoroll@skia.org Roll Skia from aef4081157f0 to 0311837abe86 (1 revision) (flutter/flutter#170992) 2025-06-23 sigurdm@google.com Run pub get post-processing for each package in workspace (flutter/flutter#170517) 2025-06-23 98614782+auto-submit[bot]@users.noreply.github.com Reverts "Fix InputDecoration.floatingLabelBehavior is not inherited (#170905)" (flutter/flutter#170994) 2025-06-23 bruno.leroux@gmail.com Fix InputDecoration.floatingLabelBehavior is not inherited (flutter/flutter#170905) 2025-06-23 engine-flutter-autoroll@skia.org Roll Skia from fcd1c55da9cc to aef4081157f0 (1 revision) (flutter/flutter#170990) 2025-06-22 robert.ancell@canonical.com Clear background in the GTK layer, instead of OpenGL (flutter/flutter#170840) 2025-06-22 robert.ancell@canonical.com Show window on first frame on Linux (flutter/flutter#170844) 2025-06-22 engine-flutter-autoroll@skia.org Roll Dart SDK from 98db1db5ff65 to bb16990911b5 (1 revision) (flutter/flutter#170988) If this roll has caused a breakage, revert this CL and stop the roller using the controls here: https://autoroll.skia.org/r/flutter-packages Please CC muhatashim@google.com,stuartmorgan@google.com on the revert to ensure that a human is aware of the problem. To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose To report a problem with the AutoRoller itself, please file a bug: https://issues.skia.org/issues/new?component=1389291&template=1850622 Documentation for the AutoRoller is here: https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md

…cated for Android 16+ (API 36+) (flutter/flutter#170816)

docs for removed opt out of edge to edge

1b1582a

github-actions bot added platform-android Android applications specifically framework flutter/packages/flutter repository. See also f: labels. engine flutter/engine related. See also e: labels. labels Jun 18, 2025

jesswrd changed the title ~~Update Docs to Warn Users Edge-To-Edge opt out is being deprecated for Android 16 (API 36) and Above~~ Update Docs to Warn Users Edge-To-Edge opt out is being deprecated for Android 16+ (API 36+) Jun 18, 2025

Merge branch 'master' into systemUiOverlay-cleanup

3876baf

jesswrd marked this pull request as ready for review June 18, 2025 17:06

jesswrd requested a review from camsim99 June 18, 2025 17:06

camsim99 approved these changes Jun 18, 2025

View reviewed changes

jesswrd added 2 commits June 18, 2025 14:23

updated more docs

b30a0cb

Merge branch 'systemUiOverlay-cleanup' of github.com:jesswrd/flutter …

88521ca

…into systemUiOverlay-cleanup

jesswrd requested a review from camsim99 June 18, 2025 18:39

camsim99 approved these changes Jun 18, 2025

View reviewed changes

jesswrd added 2 commits June 18, 2025 16:35

removed or later on (API 35) docs

381af23

grammar

6dd5148

jesswrd added the autosubmit Merge PR when tree becomes green via auto submit App label Jun 23, 2025

auto-submit bot added this pull request to the merge queue Jun 23, 2025

Merged via the queue into flutter:master with commit 20969cf Jun 23, 2025
174 checks passed

flutter-dashboard bot removed the autosubmit Merge PR when tree becomes green via auto submit App label Jun 23, 2025

engine-flutter-autoroll mentioned this pull request Jun 23, 2025

Roll Flutter from 0ab008a17228 to 20969cf26463 (14 revisions) flutter/packages#9477

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Jun 23, 2025

20969cf Update Docs to Warn Users Edge-To-Edge opt out is being depre…

1dc65f8

…cated for Android 16+ (API 36+) (flutter/flutter#170816)

engine-flutter-autoroll mentioned this pull request Jun 23, 2025

Roll Flutter from 0ab008a17228 to d733bea58c1a (16 revisions) flutter/packages#9478

Merged

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Jun 23, 2025

20969cf Update Docs to Warn Users Edge-To-Edge opt out is being depre…

97cd0ca

…cated for Android 16+ (API 36+) (flutter/flutter#170816)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Aug 14, 2025

20969cf Update Docs to Warn Users Edge-To-Edge opt out is being depre…

ba6ea2e

…cated for Android 16+ (API 36+) (flutter/flutter#170816)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Aug 14, 2025

20969cf Update Docs to Warn Users Edge-To-Edge opt out is being depre…

672eabe

…cated for Android 16+ (API 36+) (flutter/flutter#170816)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Aug 15, 2025

20969cf Update Docs to Warn Users Edge-To-Edge opt out is being depre…

896cbe0

…cated for Android 16+ (API 36+) (flutter/flutter#170816)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Aug 15, 2025

20969cf Update Docs to Warn Users Edge-To-Edge opt out is being depre…

3135c5b

…cated for Android 16+ (API 36+) (flutter/flutter#170816)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Aug 16, 2025

20969cf Update Docs to Warn Users Edge-To-Edge opt out is being depre…

92b4d45

…cated for Android 16+ (API 36+) (flutter/flutter#170816)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Update Docs to Warn Users Edge-To-Edge opt out is being deprecated for Android 16+ (API 36+) #170816

Update Docs to Warn Users Edge-To-Edge opt out is being deprecated for Android 16+ (API 36+) #170816

Uh oh!

jesswrd commented Jun 18, 2025 •

edited

Loading

Uh oh!

camsim99 left a comment •

edited

Loading

Uh oh!

camsim99 Jun 18, 2025

Uh oh!

jesswrd Jun 18, 2025

Uh oh!

camsim99 Jun 18, 2025

Uh oh!

jesswrd Jun 18, 2025

Uh oh!

camsim99 left a comment

Uh oh!

camsim99 Jun 18, 2025

Uh oh!

jesswrd Jun 20, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	// If the Flutter Android app targets Android SDK 16 (API 36), then the Android
	// If the Flutter Android app targets Android SDK 16 (API 36) or later, then the Android

	/// If your app targets Android SDK 16 (API 36) and later, then your Flutter app uses [SystemUiMode.edgeToEdge] by default
	/// If your app targets Android SDK 16 (API 36) or later, then your Flutter app uses [SystemUiMode.edgeToEdge] by default

Update Docs to Warn Users Edge-To-Edge opt out is being deprecated for Android 16+ (API 36+) #170816

Update Docs to Warn Users Edge-To-Edge opt out is being deprecated for Android 16+ (API 36+) #170816

Uh oh!

Conversation

jesswrd commented Jun 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Pre-launch Checklist

Uh oh!

camsim99 left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

camsim99 Jun 18, 2025

Choose a reason for hiding this comment

Uh oh!

jesswrd Jun 18, 2025

Choose a reason for hiding this comment

Uh oh!

camsim99 Jun 18, 2025

Choose a reason for hiding this comment

Uh oh!

jesswrd Jun 18, 2025

Choose a reason for hiding this comment

Uh oh!

camsim99 left a comment

Choose a reason for hiding this comment

Uh oh!

camsim99 Jun 18, 2025

Choose a reason for hiding this comment

Uh oh!

jesswrd Jun 20, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

jesswrd commented Jun 18, 2025 •

edited

Loading

camsim99 left a comment •

edited

Loading