flutter
[Android] Add migration documentation to handle API 35 edge-to-edge changes
According to Android 35 docs, once an Android app targets API 35, edge to edge will become the default layout mode and there are several changes coming to edge-to-edge, most notably for Flutter the coloring of the system (status and navigation) bars. In order to support Flutter apps that target API 35 and edge-to-edge mode more generally as we plan to make this the default mode on Android (see https://github.com/flutter/flutter/issues/86248), we need to develop migration documentation on how to modify one's Flutter app to adopt edge-to-edge mode.
I spoke offline to Camille. This is needed for the Q4 release, not Q3. I've asked her, when the time comes, to publish a public design doc and a breaking change page.
To clarify (I'm not clear on how this aligns with the release schedule), I plan to do this work in Q3 and will publish the breaking change page in Q4.
@sfshaza2 Going to start working on migration docs soon (not the breaking change documentation as we have not made that change yet), which will tell developers either how to opt out of edge to edge themselves or (if I can't make this work myself in the next week) tell developers how to migrate to edge to edge. Where on the website would be an appropriate place to put this documentation?
Decided to split this into two parts:
- Write a guide on how to opt out of edge to edge by default
- Write a guide on how to adopt edge to edge as a follow up to the first guide (the first guide is more of a temporary workaround and the second will give a long term solution)
- Write a guide on how to opt out of edge to edge by default
- Write a guide on how to adopt edge to edge as a follow up to the first guide (the first guide is more of a temporary workaround and the second will give a long term solution)
Has the above document been published?
I'm particularly looking forward to the second document.
The first has been published but not the 2nd, and I'm not currently planning on working on it. If there's particular concerns you have with migrating, though, let me know and I can possibly work on adding a note to the first page!
@camsim99 How to handle the cases where ui is overlapping with system nav bars in android ?
@gyanupadhyay https://github.com/flutter/website/issues/12211 outlines the available APIs, but option 3 is your best bet as of now as far as I'm aware:
Option 3, and apparently the only one that works: Go through your entire app and check every scrollable area, lists, column, bottom sheet and so on and manually add MediaQuery.viewPaddingOf(context).bottom.
For folks who have thoughts on handling edge-to-edge, that issue is the most appropriate forum!