[BottomSheet] Deprecated enableEdgeToEdge for bottom sheet dialogs on API 35+.

enableEdgeToEdge no longer takes effect on API 35 and above where edge-to-edge is now enforced. Use paddingLeft|Right|BottomSystemWindowInsets to automatically inset dialog content.

Resolves #4749
Resolves #4732
Resolves #4367

PiperOrigin-RevId: 754982643

Author: hunterstich

docs/components/BottomSheet.md

@@ -563,31 +563,26 @@ bottomSheetBehavior.removeBottomSheetCallback(bottomSheetCallback)
 <details>
   <summary><h3>Handling insets and fullscreen</h3></summary>
 
-`BottomSheetBehavior` can automatically handle insets (such as for
-[edge to edge](https://developer.android.com/training/gestures/edge-to-edge)) by
-specifying any of these to true on the view:
+`BottomSheetBehavior` automatically handles window insets by applying padding to
+the top and bottom of the view and margins to the left and right. These
+paddings and margins can be customized by specifying any of the following
+attributes on the view:
 
 *   `app:paddingBottomSystemWindowInsets`
 *   `app:paddingLeftSystemWindowInsets`
 *   `app:paddingRightSystemWindowInsets`
 *   `app:paddingTopSystemWindowInsets`
 
-On API 21 and above the modal bottom sheet will be rendered fullscreen (edge to
-edge) if the navigation bar is transparent and `enableEdgeToEdge` is true.
-To enable edge-to-edge by default for modal bottom sheets, you can override
-`?attr/bottomSheetDialogTheme` like the below example (`enableEdgeToEdge` is
-already true in `ThemeOverlay.Material3.BottomSheetDialog`):
+*   `app:marginLeftSystemWindowInsets`
+*   `app:marginRightSystemWindowInsets`
+*   `app:marginTopSystemWindowInsets`
 
-```xml
-<style name="AppTheme" parent="Theme.Material3.*">
-  ...
-  <item name="bottomSheetDialogTheme">@style/ThemeOverlay.App.BottomSheetDialog</item>
-</style>
+Modal bottom sheets are rendered fullscreen by default. On API 21-34, this can
+be overriden by setting `enableEdgeToEdge` to `false` in your
+`?attr/bottomSheetDialogTheme` ThemeOverlay. On API 35 and above,
+`enableEdgeToEdge` has been deprecated and will no longer take effect. To
+learn more, read about [edge-to-edge enforcement on Android 15](https://developer.android.com/about/versions/15/behavior-changes-15#edge-to-edge).
 
-<style name="ThemeOverlay.App.BottomSheetDialog" parent="ThemeOverlay.Material3.BottomSheetDialog">
-    <item name="android:navigationBarColor">@android:color/transparent<item>
-</style>
-```
 Insets can be added automatically if any of the padding attributes above are set
 to true in the style, either by updating the style passed to the constructor, or
 by updating the default style specified by the `?attr/bottomSheetDialogTheme`

lib/java/com/google/android/material/bottomsheet/BottomSheetDialog.java

@@ -110,12 +110,15 @@ protected BottomSheetDialog(
   }
 
   private void initialize() {
+    if (VERSION.SDK_INT >= VERSION_CODES.VANILLA_ICE_CREAM) {
+      edgeToEdgeEnabled = true;
+      return;
+    }
+
     final TypedArray a = getContext()
         .getTheme()
         .obtainStyledAttributes(new int[] {R.attr.enableEdgeToEdge});
-
     edgeToEdgeEnabled = a.getBoolean(0, false);
-
     a.recycle();
   }
 
@@ -129,8 +132,10 @@ protected void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
     Window window = getWindow();
     if (window != null) {
-      // The status bar should always be transparent because of the window animation.
-      window.setStatusBarColor(0);
+      if (VERSION.SDK_INT < VERSION_CODES.VANILLA_ICE_CREAM) {
+        // The status bar should always be transparent because of the window animation.
+        window.setStatusBarColor(0);
+      }
 
       window.addFlags(LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
       if (VERSION.SDK_INT < VERSION_CODES.M) {
@@ -180,9 +185,7 @@ public void onAttachedToWindow() {
     super.onAttachedToWindow();
     Window window = getWindow();
     if (window != null) {
-      // If the navigation bar is transparent at all the BottomSheet should be edge to edge.
-      boolean drawEdgeToEdge =
-          edgeToEdgeEnabled && Color.alpha(window.getNavigationBarColor()) < 255;
+      boolean drawEdgeToEdge = shouldDrawEdgeToEdge(window);
       if (container != null) {
         container.setFitsSystemWindows(!drawEdgeToEdge);
       }
@@ -199,6 +202,14 @@ public void onAttachedToWindow() {
     updateListeningForBackCallbacks();
   }
 
+  private boolean shouldDrawEdgeToEdge(Window window) {
+    if (VERSION.SDK_INT >= VERSION_CODES.VANILLA_ICE_CREAM) {
+      return true;
+    }
+
+    return edgeToEdgeEnabled && Color.alpha(window.getNavigationBarColor()) < 255;
+  }
+
   @Override
   public void onDetachedFromWindow() {
     if (edgeToEdgeCallback != null) {

lib/java/com/google/android/material/bottomsheet/res/values/attrs.xml

@@ -21,6 +21,7 @@
   <!-- Style to use for modal bottom sheets in this theme. -->
   <attr name="bottomSheetStyle" format="reference"/>
   <!-- Determines if the BottomSheetDialog should be shown in edge to edge mode. -->
+  <!-- Deprecated. Edge to Edge is always enabled on API 35 and above. -->
   <attr name="enableEdgeToEdge" format="boolean" />
   <!-- Style of drag handle views when being used with bottom sheets. -->
   <attr name="bottomSheetDragHandleStyle" format="reference"/>