Merge branch 'main' into chore/update-root-packages

Author: ItsChaceD

status-bar/README.md

@@ -159,6 +159,7 @@ setBackgroundColor(options: BackgroundColorOptions) => Promise<void>
 ```
 
 Set the background color of the status bar.
+Calling this function updates the foreground color of the status bar if the style is set to default, except on iOS versions lower than 17.
 Not available on Android 15+.
 
 | Param         | Type                                                                      |

status-bar/android/src/main/java/com/capacitorjs/plugins/statusbar/StatusBar.java

@@ -4,11 +4,13 @@
 import android.graphics.Color;
 import android.os.Build;
 import android.util.DisplayMetrics;
+import android.util.TypedValue;
 import android.view.View;
 import android.view.Window;
 import android.view.WindowInsets;
 import android.view.WindowManager;
 import androidx.appcompat.app.AppCompatActivity;
+import androidx.core.graphics.ColorUtils;
 import androidx.core.view.ViewCompat;
 import androidx.core.view.WindowCompat;
 import androidx.core.view.WindowInsetsCompat;
@@ -63,11 +65,20 @@ public void updateStyle() {
 
     public void setBackgroundColor(int color) {
         Window window = activity.getWindow();
-        clearTranslucentStatusFlagDeprecated();
-        window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
-        setStatusBarColorDeprecated(color);
-        // update the local color field as well
-        currentStatusBarColor = color;
+        if (shouldSetStatusBarColor(isEdgeToEdgeOptOutEnabled(window))) {
+            clearTranslucentStatusFlagDeprecated();
+            window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
+            setStatusBarColorDeprecated(color);
+            currentStatusBarColor = color;
+
+            // only set foreground color if style is default
+            if (currentStyle.equals("DEFAULT")) {
+                // determine if the color is light or dark using luminance and set icon color
+                boolean isLightColor = ColorUtils.calculateLuminance(color) > 0.5;
+                WindowInsetsControllerCompat insetsController = WindowCompat.getInsetsController(window, window.getDecorView());
+                insetsController.setAppearanceLightStatusBars(isLightColor);
+            }
+        }
     }
 
     public void hide() {
@@ -107,6 +118,29 @@ public void setOverlaysWebView(Boolean overlays) {
         listener.onChange(statusBarOverlayChanged, getInfo());
     }
 
+    private boolean shouldSetStatusBarColor(boolean hasOptOut) {
+        boolean canSetStatusBar;
+        int deviceApi = Build.VERSION.SDK_INT;
+        if (deviceApi < Build.VERSION_CODES.VANILLA_ICE_CREAM) {
+            // device below Android 15 - can always set status bar
+            canSetStatusBar = true;
+        } else if (deviceApi == Build.VERSION_CODES.VANILLA_ICE_CREAM) {
+            canSetStatusBar = hasOptOut; // app targets 15 - can set status bar if opted out
+        } else {
+            canSetStatusBar = false; // app targets 16 - opt-out ignored or app targets 15 but there is not opt out
+        }
+        return canSetStatusBar;
+    }
+
+    private boolean isEdgeToEdgeOptOutEnabled(Window window) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.VANILLA_ICE_CREAM) {
+            TypedValue value = new TypedValue();
+            window.getContext().getTheme().resolveAttribute(android.R.attr.windowOptOutEdgeToEdgeEnforcement, value, true);
+            return value.data != 0; // value is set to -1 on true as of Android 15, so we have to do this.
+        }
+        return false;
+    }
+
     private boolean getIsOverlaid() {
         return (
             (getSystemUiVisibilityDeprecated(activity.getWindow().getDecorView()) & getSystemUiFlagLayoutFullscreenDeprecated()) ==

status-bar/src/definitions.ts

@@ -170,6 +170,7 @@ export interface StatusBarPlugin {
 
   /**
    * Set the background color of the status bar.
+   * Calling this function updates the foreground color of the status bar if the style is set to default, except on iOS versions lower than 17.
    * Not available on Android 15+.
    *
    * @since 1.0.0