capacitor-plugin-status-bar 2.0.8 → 2.0.10

package/android/src/main/java/com/cap/plugins/statusbar/CapacitorStatusBar.java

@@ -58,12 +58,14 @@ public class CapacitorStatusBar extends Plugin {
         View decorView = window.getDecorView();
 
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
-            // Android 12+ (API 31+): Full edge-to-edge with overlay views.
-            // Android 12+ gesture navigation ignores setStatusBarColor/setNavigationBarColor;
-            // Android 15+ (API 35) enforces edge-to-edge mandatory. All require the overlay approach.
+            // Android 12+ (API 31+): enable edge-to-edge layout.
+            // The nav bar uses overlay views because gesture navigation ignores setNavigationBarColor().
+            // The status bar still uses setStatusBarColor() reliably on API 31–34;
+            // overlay is only needed on API 35+ where edge-to-edge is enforced and the native API is a no-op.
             WindowCompat.setDecorFitsSystemWindows(window, false);
 
-            // Make native bar colors transparent so our overlays are the sole color source
+            // Set a transparent baseline; setStyle() will apply the actual color via setStatusBarColor()
+            // (API 31-34) or the status bar overlay (API 35+).
             window.setStatusBarColor(Color.TRANSPARENT);
             window.setNavigationBarColor(Color.TRANSPARENT);
             window.setStatusBarContrastEnforced(false);
@@ -497,11 +499,12 @@ public class CapacitorStatusBar extends Plugin {
 
     private void applyStatusBarBackground(Activity activity, @ColorInt int color) {
         Log.d(TAG, "applyStatusBarBackground: color=#" + Integer.toHexString(color) + ", API=" + Build.VERSION.SDK_INT);
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
-            // Android 12+: Use overlay views (gesture nav ignores setStatusBarColor; mandatory on 15+)
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.VANILLA_ICE_CREAM) {
+            // Android 15+ (API 35+): edge-to-edge is enforced, setStatusBarColor() is a no-op
             ensureStatusBarOverlay(activity, color);
         } else {
-            // Android < 12: Use native window API directly
+            // API 29–34: setStatusBarColor() works reliably for the status bar on all navigation modes.
+            // Note: gesture navigation only ignores setNavigationBarColor(), not setStatusBarColor().
             activity.getWindow().setStatusBarColor(color);
         }
     }
@@ -509,11 +512,13 @@ public class CapacitorStatusBar extends Plugin {
     private void applyNavigationBarBackground(Activity activity, @ColorInt int color) {
         Log.d(TAG, "applyNavigationBarBackground: color=#" + Integer.toHexString(color) + ", API="
                 + Build.VERSION.SDK_INT);
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
-            // Android 12+: Use overlay views (gesture nav ignores setNavigationBarColor; mandatory on 15+)
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.VANILLA_ICE_CREAM) {
+            // Android 15+ (API 35+): edge-to-edge enforced, setNavigationBarColor() is a no-op
             ensureNavBarOverlay(activity, color);
         } else {
-            // Android < 12: Use native window API directly
+            // API 29–34: setNavigationBarColor() works for button navigation.
+            // Gesture navigation ignores it (system enforces transparency for gesture handles),
+            // but in that case there is no visible nav bar to color anyway.
             activity.getWindow().setNavigationBarColor(color);
         }
     }
@@ -629,25 +634,23 @@ public class CapacitorStatusBar extends Plugin {
      */
     private void makeStatusBarBackgroundTransparent(Activity activity) {
         Log.d(TAG, "makeStatusBarBackgroundTransparent: API=" + Build.VERSION.SDK_INT);
+        Window window = activity.getWindow();
+        ViewGroup decorView = (ViewGroup) window.getDecorView();
 
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
-            // Android 12+: Set overlay backgrounds to transparent
-            ViewGroup decorView = (ViewGroup) activity.getWindow().getDecorView();
-
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.VANILLA_ICE_CREAM) {
+            // Android 15+: both bars use overlay views
             View statusBarOverlay = decorView.findViewWithTag(STATUS_BAR_OVERLAY_TAG);
             if (statusBarOverlay != null) {
                 statusBarOverlay.setBackgroundColor(Color.TRANSPARENT);
                 Log.d(TAG, "makeStatusBarBackgroundTransparent: status bar overlay made transparent");
             }
-
             View navBarOverlay = decorView.findViewWithTag(NAV_BAR_OVERLAY_TAG);
             if (navBarOverlay != null) {
                 navBarOverlay.setBackgroundColor(Color.TRANSPARENT);
-                Log.d(TAG, "makeStatusBarBackgroundTransparent: navigation bar overlay made transparent");
+                Log.d(TAG, "makeStatusBarBackgroundTransparent: nav bar overlay made transparent");
             }
         } else {
-            // Android < 13: Use native window API directly
-            Window window = activity.getWindow();
+            // API 29–34: both bars use native window API
             window.setStatusBarColor(Color.TRANSPARENT);
             window.setNavigationBarColor(Color.TRANSPARENT);
             Log.d(TAG, "makeStatusBarBackgroundTransparent: set native bar colors to transparent");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capacitor-plugin-status-bar",
-  "version": "2.0.8",
+  "version": "2.0.10",
   "description": "Capacitor plugin for managing the status bar style, visibility, and color on iOS and Android. Control overlay modes, background colors, and appearance for native mobile applications.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",