Deprecated methods that call setStatusBarColor, setNavigationBarColor, setNavigationBarDividerColor (flutter#165737)

Added @deprecated annotation and explanation to methods that use these
methods: setStatusBarColor, setNavigationBarColor,
setNavigationBarDividerColor

This PR partially addresses flutter#165327

---------

Co-authored-by: Reid Baker <[email protected]>
Co-authored-by: Camille Simon <[email protected]>
Co-authored-by: Camille Simon <[email protected]>

Author: 3 people

engine/src/flutter/shell/platform/android/io/flutter/embedding/android/FlutterActivity.java

@@ -808,6 +808,12 @@ private View createFlutterView() {
         /*shouldDelayFirstAndroidViewDraw=*/ getRenderMode() == RenderMode.surface);
   }
 
+  /**
+   * @deprecated This method is outdated because it calls {@code setStatusBarColor}, which is
+   *     deprecated in Android 15 and above. Consider using the new WindowInsetsController or other
+   *     Android 15+ APIs for system UI styling.
+   */
+  @Deprecated
   private void configureStatusBarForFullscreenFlutterExperience() {
     Window window = getWindow();
     window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);

engine/src/flutter/shell/platform/android/io/flutter/embedding/android/FlutterFragmentActivity.java

@@ -600,6 +600,12 @@ protected FlutterFragment createFlutterFragment() {
     }
   }
 
+  /**
+   * @deprecated This method is outdated because it calls {@code setStatusBarColor}, which is
+   *     deprecated in Android 15 and above. Consider using the new WindowInsetsController or other
+   *     Android 15+ APIs for system UI styling.
+   */
+  @Deprecated
   private void configureStatusBarForFullscreenFlutterExperience() {
     Window window = getWindow();
     window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);

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

@@ -403,7 +403,13 @@ private void restoreSystemChromeSystemUIOverlays() {
     updateSystemUiOverlays();
   }
 
-  @SuppressWarnings("deprecation")
+  /**
+   * @deprecated This method is outdated because it calls {@code setStatusBarColor}, {@code
+   *     setNavigationBarColor} and {@code setNavigationBarDividerColor}, which are deprecated in
+   *     Android 15 and above. Consider using the new WindowInsetsController or other Android 15+
+   *     APIs for system UI styling.
+   */
+  @Deprecated
   private void setSystemChromeSystemUIOverlayStyle(
       PlatformChannel.SystemChromeStyle systemChromeStyle) {
     Window window = activity.getWindow();