@capawesome/capacitor-android-edge-to-edge-support 7.2.3 → 8.0.1

package/README.md

@@ -2,16 +2,25 @@
 
 Capacitor plugin to support [edge-to-edge](https://developer.android.com/develop/ui/views/layout/edge-to-edge) display on Android with advanced features like setting the background color of the status bar and navigation bar.
 
-| Before                                                                                                      | After                                                                                                       | Before                                                                                                      | After                                                                                                       |
-| ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| <image src="https://github.com/user-attachments/assets/1c42aa63-1191-4b9b-860f-ffc47881d815" width="200" /> | <image src="https://github.com/user-attachments/assets/a4df4e58-0c21-45b5-aadd-ca197308016a" width="200" /> | <image src="https://github.com/user-attachments/assets/22c94f95-a0c4-4ace-8a3b-3a0feabf9191" width="200" /> | <image src="https://github.com/user-attachments/assets/21ece022-fb74-4067-889b-6922ecd0e2a5" width="200" /> |
-
 <div class="capawesome-z29o10a">
   <a href="https://cloud.capawesome.io/" target="_blank">
-    <img alt="Deliver Live Updates to your Capacitor app with Capawesome Cloud" src="https://cloud.capawesome.io/assets/banners/cloud-deploy-real-time-app-updates.png?t=1" />
+    <img alt="Deliver Live Updates to your Capacitor app with Capawesome Cloud" src="https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1" />
   </a>
 </div>
 
+| Before                                                                                                      | After                                                                                                       | Before                                                                                                      | After                                                                                                       |
+| ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
+| <image src="https://github.com/user-attachments/assets/1c42aa63-1191-4b9b-860f-ffc47881d815" width="200" /> | <image src="https://github.com/user-attachments/assets/a4df4e58-0c21-45b5-aadd-ca197308016a" width="200" /> | <image src="https://github.com/user-attachments/assets/22c94f95-a0c4-4ace-8a3b-3a0feabf9191" width="200" /> | <image src="https://github.com/user-attachments/assets/21ece022-fb74-4067-889b-6922ecd0e2a5" width="200" /> |
+
+**Attention:** Despite its name, this plugin doesn't enable edge-to-edge mode by default. Instead, it preserves the traditional app behavior by applying proper insets to the webview, preventing Android's edge-to-edge changes from affecting apps that haven't been designed to support it.
+
+## Compatibility
+
+| Plugin Version | Capacitor Version | Status         |
+| -------------- | ----------------- | -------------- |
+| 8.x.x          | >=8.x.x           | Active support |
+| 7.x.x          | 7.x.x             | Deprecated     |
+
 ## Installation
 
 ```bash
@@ -21,7 +30,25 @@ npx cap sync
 
 ### Android
 
-If you are using the [Capacitor Keyboard](https://capacitorjs.com/docs/apis/keyboard) plugin, make sure to set the `resizeOnFullScreen` property to `false` (default) in your Capacitor Configuration file:
+#### Capacitor SystemBars Plugin
+
+Make sure to disable the built-in insets handling of the [Capacitor SystemBars](https://capacitorjs.com/docs/apis/system-bars) plugin in your [Capacitor Configuration](https://capacitorjs.com/docs/config) file:
+
+```json
+{
+  "plugins": {
+    "SystemBars": {
+      "insetsHandling": "disable"
+    }
+  }
+}
+```
+
+Please note that this plugin is part of the Capacitor core and the insets handling is **always enabled by default**.
+
+#### Capacitor Keyboard Plugin
+
+If you are using the [Capacitor Keyboard](https://capacitorjs.com/docs/apis/keyboard) plugin, make sure to set the `resizeOnFullScreen` property to `false` (default) in your [Capacitor Configuration](https://capacitorjs.com/docs/config) file:
 
 ```json
 {
@@ -40,9 +67,11 @@ Otherwise, the web view will be resized to fit the screen, which may cause issue
 <docgen-config>
 <!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
 
-| Prop                  | Type                | Description                                                                                | Since |
-| --------------------- | ------------------- | ------------------------------------------------------------------------------------------ | ----- |
-| **`backgroundColor`** | <code>string</code> | The hexadecimal color to set as the background color of the status bar and navigation bar. | 7.1.0 |
+| Prop                     | Type                | Description                                                                                                 | Since |
+| ------------------------ | ------------------- | ----------------------------------------------------------------------------------------------------------- | ----- |
+| **`backgroundColor`**    | <code>string</code> | The hexadecimal color to set as the background color of the status bar and navigation bar.                  | 7.1.0 |
+| **`navigationBarColor`** | <code>string</code> | The hexadecimal color to set as the background color of the navigation bar area. Only available on Android. | 8.0.0 |
+| **`statusBarColor`**     | <code>string</code> | The hexadecimal color to set as the background color of the status bar area. Only available on Android.     | 8.0.0 |
 
 ### Examples
 
@@ -52,7 +81,9 @@ In `capacitor.config.json`:
 {
   "plugins": {
     "EdgeToEdge": {
-      "backgroundColor": "#ffffff"
+      "backgroundColor": "#ffffff",
+      "navigationBarColor": "#000000",
+      "statusBarColor": "#ffffff"
     }
   }
 }
@@ -69,6 +100,8 @@ const config: CapacitorConfig = {
   plugins: {
     EdgeToEdge: {
       backgroundColor: "#ffffff",
+      navigationBarColor: "#000000",
+      statusBarColor: "#ffffff",
     },
   },
 };
@@ -80,11 +113,11 @@ export default config;
 
 ## Usage
 
-The plugin **only needs to be installed**. It applies insets to the web view to support edge-to-edge display on Android. The plugin also provides a method to set the background color of the status bar and navigation bar. It's recommended to use this method in combination with the [Status Bar](https://capacitorjs.com/docs/apis/status-bar) plugin.
+The plugin **only needs to be installed**. It applies insets to the web view to support edge-to-edge display on Android. The plugin also provides a method to set the background color of the status bar and navigation bar. It's recommended to use this method in combination with the [SystemBars](https://capacitorjs.com/docs/apis/system-bars) plugin.
 
 ```typescript
 import { EdgeToEdge } from '@capawesome/capacitor-android-edge-to-edge-support';
-import { StatusBar, Style } from '@capacitor/status-bar';
+import { SystemBars, SystemBarsStyle } from '@capacitor/core';
 
 const enable = async () => {
   await EdgeToEdge.enable();
@@ -99,9 +132,14 @@ const getInsets = async () => {
   console.log('Insets:', result);
 };
 
-const setBackgroundColor = async () => {
-  await EdgeToEdge.setBackgroundColor({ color: '#ffffff' });
-  await StatusBar.setStyle({ style: Style.Light });
+const setDarkStyle = async () => {
+  await SystemBars.setStyle({ style: SystemBarsStyle.Dark });
+  await EdgeToEdge.setBackgroundColor({ color: '#000000' });
+};
+
+const setLightStyle = async () => {
+  await SystemBars.setStyle({ style: SystemBarsStyle.Light });
+  await EdgeToEdge.setBackgroundColor({ color: '#FFFFFF' });
 };
 ```
 
@@ -109,10 +147,12 @@ const setBackgroundColor = async () => {
 
 <docgen-index>
 
-* [`enable()`](#enable)
 * [`disable()`](#disable)
+* [`enable()`](#enable)
 * [`getInsets()`](#getinsets)
 * [`setBackgroundColor(...)`](#setbackgroundcolor)
+* [`setNavigationBarColor(...)`](#setnavigationbarcolor)
+* [`setStatusBarColor(...)`](#setstatusbarcolor)
 * [Interfaces](#interfaces)
 
 </docgen-index>
@@ -120,13 +160,13 @@ const setBackgroundColor = async () => {
 <docgen-api>
 <!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
 
-### enable()
+### disable()
 
 ```typescript
-enable() => Promise<void>
+disable() => Promise<void>
 ```
 
-Enable the edge-to-edge mode.
+Disable the edge-to-edge mode.
 
 Only available on Android.
 
@@ -135,13 +175,13 @@ Only available on Android.
 --------------------
 
 
-### disable()
+### enable()
 
 ```typescript
-disable() => Promise<void>
+enable() => Promise<void>
 ```
 
-Disable the edge-to-edge mode.
+Enable the edge-to-edge mode.
 
 Only available on Android.
 
@@ -186,6 +226,44 @@ Only available on Android.
 --------------------
 
 
+### setNavigationBarColor(...)
+
+```typescript
+setNavigationBarColor(options: SetNavigationBarColorOptions) => Promise<void>
+```
+
+Set the background color of the navigation bar area.
+
+Only available on Android.
+
+| Param         | Type                                                                                  |
+| ------------- | ------------------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#setnavigationbarcoloroptions">SetNavigationBarColorOptions</a></code> |
+
+**Since:** 8.0.0
+
+--------------------
+
+
+### setStatusBarColor(...)
+
+```typescript
+setStatusBarColor(options: SetStatusBarColorOptions) => Promise<void>
+```
+
+Set the background color of the status bar area.
+
+Only available on Android.
+
+| Param         | Type                                                                          |
+| ------------- | ----------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#setstatusbarcoloroptions">SetStatusBarColorOptions</a></code> |
+
+**Since:** 8.0.0
+
+--------------------
+
+
 ### Interfaces
 
 
@@ -205,8 +283,32 @@ Only available on Android.
 | ----------- | ------------------- | ------------------------------------------------------------------------------------------ | ----- |
 | **`color`** | <code>string</code> | The hexadecimal color to set as the background color of the status bar and navigation bar. | 7.0.0 |
 
+
+#### SetNavigationBarColorOptions
+
+| Prop        | Type                | Description                                                                      | Since |
+| ----------- | ------------------- | -------------------------------------------------------------------------------- | ----- |
+| **`color`** | <code>string</code> | The hexadecimal color to set as the background color of the navigation bar area. | 8.0.0 |
+
+
+#### SetStatusBarColorOptions
+
+| Prop        | Type                | Description                                                                  | Since |
+| ----------- | ------------------- | ---------------------------------------------------------------------------- | ----- |
+| **`color`** | <code>string</code> | The hexadecimal color to set as the background color of the status bar area. | 8.0.0 |
+
 </docgen-api>
 
+## FAQ
+
+### What about Capacitor 8's built-in edge-to-edge support?
+
+Capacitor 8 introduced native edge-to-edge functionality through the internal `SystemBars` plugin. While this covers many common scenarios, this plugin addresses additional edge cases that aren't yet fully resolved in the Capacitor core implementation. We plan to deprecate this plugin once all edge cases are properly handled in Capacitor core.
+
+### Is this plugin compatible with Capacitor's SystemBars API?
+
+Yes, this plugin is partially compatible with the new [SystemBars API](https://capacitorjs.com/docs/apis/system-bars) introduced in Capacitor 8. For example, methods like `setStyle()` from the SystemBars API are supported and can be used alongside this plugin without conflicts.
+
 ## Changelog
 
 See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/android-edge-to-edge-support/CHANGELOG.md).

package/android/build.gradle

@@ -1,8 +1,8 @@
 ext {
     junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
-    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.0'
-    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.2.1'
-    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.6.1'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
 }
 
 buildscript {
@@ -11,21 +11,22 @@ buildscript {
         mavenCentral()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:8.7.2'
+        classpath 'com.android.tools.build:gradle:8.13.0'
     }
 }
 
 apply plugin: 'com.android.library'
 
 android {
-    namespace "io.capawesome.capacitorjs.plugins.androidedgetoedge"
-    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 35
+    namespace = "io.capawesome.capacitorjs.plugins.androidedgetoedge"
+    compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 36
     defaultConfig {
-        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
-        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 35
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 24
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 36
         versionCode 1
         versionName "1.0"
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+        consumerProguardFiles 'consumer-rules.pro'
     }
     buildTypes {
         release {
@@ -34,7 +35,7 @@ android {
         }
     }
     lintOptions {
-        abortOnError false
+        abortOnError = false
     }
     compileOptions {
         sourceCompatibility JavaVersion.VERSION_21

package/android/src/main/java/io/capawesome/capacitorjs/plugins/androidedgetoedgesupport/EdgeToEdge.java

@@ -2,13 +2,17 @@ package io.capawesome.capacitorjs.plugins.androidedgetoedgesupport;
 
 import android.graphics.Color;
 import android.os.Build;
+import android.view.Gravity;
 import android.view.View;
 import android.view.ViewGroup;
+import android.widget.FrameLayout;
 import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
 import androidx.core.graphics.Insets;
 import androidx.core.view.ViewCompat;
 import androidx.core.view.WindowInsetsCompat;
 import com.getcapacitor.Logger;
+import java.lang.reflect.Constructor;
 
 public class EdgeToEdge {
 
@@ -18,11 +22,21 @@ public class EdgeToEdge {
     @NonNull
     private final EdgeToEdgePlugin plugin;
 
+    @Nullable
+    private View navigationBarOverlay;
+
+    @Nullable
+    private View statusBarOverlay;
+
     public EdgeToEdge(@NonNull EdgeToEdgePlugin plugin, @NonNull EdgeToEdgeConfig config) {
         this.config = config;
         this.plugin = plugin;
-        // Apply insets to disable the edge-to-edge feature
-        setBackgroundColor(config.getBackgroundColor());
+        // Create color overlays
+        createColorOverlays();
+        // Set colors from config
+        setStatusBarColor(config.getStatusBarColor());
+        setNavigationBarColor(config.getNavigationBarColor());
+        // Apply insets to enable the edge-to-edge feature
         applyInsets();
     }
 
@@ -40,7 +54,17 @@ public class EdgeToEdge {
     }
 
     public void setBackgroundColor(String color) {
-        setBackgroundColor(Color.parseColor(color));
+        int parsedColor = Color.parseColor(color);
+        setStatusBarColor(parsedColor);
+        setNavigationBarColor(parsedColor);
+    }
+
+    public void setNavigationBarColor(String color) {
+        setNavigationBarColor(Color.parseColor(color));
+    }
+
+    public void setStatusBarColor(String color) {
+        setStatusBarColor(Color.parseColor(color));
     }
 
     private void applyInsets() {
@@ -64,6 +88,9 @@ public class EdgeToEdge {
             mlp.rightMargin = systemBarsInsets.right;
 
             view.setLayoutParams(mlp);
+
+            // Update color overlays based on current insets
+            updateColorOverlays(systemBarsInsets);
         }
         // Set listener
         ViewCompat.setOnApplyWindowInsetsListener(view, (v, windowInsets) -> {
@@ -87,6 +114,9 @@ public class EdgeToEdge {
 
             v.setLayoutParams(mlp);
 
+            // Update color overlays based on current insets
+            updateColorOverlays(systemBarsInsets);
+
             return WindowInsetsCompat.CONSUMED;
         });
     }
@@ -104,13 +134,105 @@ public class EdgeToEdge {
         view.setLayoutParams(mlp);
         // Reset listener
         ViewCompat.setOnApplyWindowInsetsListener(view, null);
+        // Remove color overlays
+        removeColorOverlays();
     }
 
-    private void setBackgroundColor(int color) {
-        View view = plugin.getBridge().getWebView();
-        // Get parent view
-        ViewGroup parent = (ViewGroup) view.getParent();
-        // Set background color
-        parent.setBackgroundColor(color);
+    private void createColorOverlays() {
+        View webView = plugin.getBridge().getWebView();
+        ViewGroup parent = (ViewGroup) webView.getParent();
+
+        if (statusBarOverlay == null) {
+            statusBarOverlay = new View(parent.getContext());
+            parent.addView(statusBarOverlay, 0); // Add behind webview
+        }
+
+        if (navigationBarOverlay == null) {
+            navigationBarOverlay = new View(parent.getContext());
+            parent.addView(navigationBarOverlay, 0); // Add behind webview
+        }
+    }
+
+    private void removeColorOverlays() {
+        View webView = plugin.getBridge().getWebView();
+        ViewGroup parent = (ViewGroup) webView.getParent();
+
+        if (statusBarOverlay != null) {
+            parent.removeView(statusBarOverlay);
+            statusBarOverlay = null;
+        }
+
+        if (navigationBarOverlay != null) {
+            parent.removeView(navigationBarOverlay);
+            navigationBarOverlay = null;
+        }
+    }
+
+    private void setNavigationBarColor(int color) {
+        if (navigationBarOverlay != null) {
+            navigationBarOverlay.setBackgroundColor(color);
+        }
+    }
+
+    private void setStatusBarColor(int color) {
+        if (statusBarOverlay != null) {
+            statusBarOverlay.setBackgroundColor(color);
+        }
+    }
+
+    private void updateColorOverlays(Insets systemBarsInsets) {
+        View webView = plugin.getBridge().getWebView();
+        ViewGroup parent = (ViewGroup) webView.getParent();
+
+        if (statusBarOverlay != null) {
+            // Position status bar overlay at top
+            ViewGroup.LayoutParams statusParams = createLayoutParams(
+                parent,
+                ViewGroup.LayoutParams.MATCH_PARENT,
+                systemBarsInsets.top,
+                Gravity.TOP
+            );
+            statusBarOverlay.setLayoutParams(statusParams);
+        }
+
+        if (navigationBarOverlay != null) {
+            // Position navigation bar overlay at bottom
+            ViewGroup.LayoutParams navParams = createLayoutParams(
+                parent,
+                ViewGroup.LayoutParams.MATCH_PARENT,
+                systemBarsInsets.bottom,
+                Gravity.BOTTOM
+            );
+            navigationBarOverlay.setLayoutParams(navParams);
+        }
+    }
+
+    private ViewGroup.LayoutParams createLayoutParams(ViewGroup parent, int width, int height, int gravity) {
+        String parentClassName = parent.getClass().getName();
+
+        // Handle CoordinatorLayout using reflection
+        if (parentClassName.contains("CoordinatorLayout")) {
+            try {
+                Class<?> layoutParamsClass = Class.forName("androidx.coordinatorlayout.widget.CoordinatorLayout$LayoutParams");
+                Constructor<?> constructor = layoutParamsClass.getConstructor(int.class, int.class);
+                ViewGroup.LayoutParams params = (ViewGroup.LayoutParams) constructor.newInstance(width, height);
+                // Set gravity using reflection
+                layoutParamsClass.getField("gravity").setInt(params, gravity);
+                return params;
+            } catch (Exception e) {
+                Logger.error("EdgeToEdge", "Failed to create CoordinatorLayout.LayoutParams", e);
+            }
+        }
+
+        // Handle FrameLayout
+        if (parent instanceof FrameLayout) {
+            FrameLayout.LayoutParams params = new FrameLayout.LayoutParams(width, height);
+            params.gravity = gravity;
+            return params;
+        }
+
+        // Fallback to MarginLayoutParams
+        ViewGroup.MarginLayoutParams params = new ViewGroup.MarginLayoutParams(width, height);
+        return params;
     }
 }

package/android/src/main/java/io/capawesome/capacitorjs/plugins/androidedgetoedgesupport/EdgeToEdgeConfig.java

@@ -4,13 +4,31 @@ import android.graphics.Color;
 
 public class EdgeToEdgeConfig {
 
-    private int backgroundColor = Color.WHITE;
+    private int backgroundColor = Color.TRANSPARENT;
+    private int navigationBarColor = Color.TRANSPARENT;
+    private int statusBarColor = Color.TRANSPARENT;
 
     public int getBackgroundColor() {
         return this.backgroundColor;
     }
 
+    public int getNavigationBarColor() {
+        return this.navigationBarColor;
+    }
+
+    public int getStatusBarColor() {
+        return this.statusBarColor;
+    }
+
     public void setBackgroundColor(int backgroundColor) {
         this.backgroundColor = backgroundColor;
     }
+
+    public void setNavigationBarColor(int navigationBarColor) {
+        this.navigationBarColor = navigationBarColor;
+    }
+
+    public void setStatusBarColor(int statusBarColor) {
+        this.statusBarColor = statusBarColor;
+    }
 }

package/android/src/main/java/io/capawesome/capacitorjs/plugins/androidedgetoedgesupport/EdgeToEdgePlugin.java

@@ -82,11 +82,64 @@ public class EdgeToEdgePlugin extends Plugin {
             });
     }
 
+    @PluginMethod
+    public void setNavigationBarColor(PluginCall call) {
+        String color = call.getString("color");
+        if (color == null) {
+            call.reject(ERROR_COLOR_MISSING);
+            return;
+        }
+        getActivity()
+            .runOnUiThread(() -> {
+                try {
+                    implementation.setNavigationBarColor(color);
+                    call.resolve();
+                } catch (Exception exception) {
+                    call.reject(exception.getMessage());
+                }
+            });
+    }
+
+    @PluginMethod
+    public void setStatusBarColor(PluginCall call) {
+        String color = call.getString("color");
+        if (color == null) {
+            call.reject(ERROR_COLOR_MISSING);
+            return;
+        }
+        getActivity()
+            .runOnUiThread(() -> {
+                try {
+                    implementation.setStatusBarColor(color);
+                    call.resolve();
+                } catch (Exception exception) {
+                    call.reject(exception.getMessage());
+                }
+            });
+    }
+
     private EdgeToEdgeConfig getEdgeToEdgeConfig() {
         EdgeToEdgeConfig config = new EdgeToEdgeConfig();
 
         try {
             String backgroundColor = getConfig().getString("backgroundColor");
+            String statusBarColor = getConfig().getString("statusBarColor");
+            String navigationBarColor = getConfig().getString("navigationBarColor");
+
+            // Backward compatibility: if backgroundColor is set but specific colors aren't, use it for both
+            if (statusBarColor == null && backgroundColor != null) {
+                config.setStatusBarColor(Color.parseColor(backgroundColor));
+            } else if (statusBarColor != null) {
+                config.setStatusBarColor(Color.parseColor(statusBarColor));
+            }
+
+            if (navigationBarColor == null && backgroundColor != null) {
+                config.setNavigationBarColor(Color.parseColor(backgroundColor));
+            } else if (navigationBarColor != null) {
+                config.setNavigationBarColor(Color.parseColor(navigationBarColor));
+            }
+
+            // Keep backgroundColor for any legacy code that might use it
             if (backgroundColor != null) {
                 config.setBackgroundColor(Color.parseColor(backgroundColor));
             }

package/android/src/main/java/io/capawesome/capacitorjs/plugins/androidedgetoedgesupport/classes/options/SetNavigationBarColorOptions.java

@@ -0,0 +1,28 @@
+package io.capawesome.capacitorjs.plugins.androidedgetoedgesupport.classes.options;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.PluginCall;
+
+public class SetNavigationBarColorOptions {
+
+    @NonNull
+    private final String color;
+
+    public SetNavigationBarColorOptions(@NonNull PluginCall call) throws Exception {
+        this.color = getColorFromCall(call);
+    }
+
+    @NonNull
+    public String getColor() {
+        return color;
+    }
+
+    @NonNull
+    private static String getColorFromCall(@NonNull PluginCall call) throws Exception {
+        String color = call.getString("color");
+        if (color == null) {
+            throw new Exception("color must be provided.");
+        }
+        return color;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/androidedgetoedgesupport/classes/options/SetStatusBarColorOptions.java

@@ -0,0 +1,28 @@
+package io.capawesome.capacitorjs.plugins.androidedgetoedgesupport.classes.options;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.PluginCall;
+
+public class SetStatusBarColorOptions {
+
+    @NonNull
+    private final String color;
+
+    public SetStatusBarColorOptions(@NonNull PluginCall call) throws Exception {
+        this.color = getColorFromCall(call);
+    }
+
+    @NonNull
+    public String getColor() {
+        return color;
+    }
+
+    @NonNull
+    private static String getColorFromCall(@NonNull PluginCall call) throws Exception {
+        String color = call.getString("color");
+        if (color == null) {
+            throw new Exception("color must be provided.");
+        }
+        return color;
+    }
+}

package/dist/docs.json

@@ -6,7 +6,7 @@
     "tags": [],
     "methods": [
       {
-        "name": "enable",
+        "name": "disable",
         "signature": "() => Promise<void>",
         "parameters": [],
         "returns": "Promise<void>",
@@ -16,12 +16,12 @@
             "text": "7.2.0"
           }
         ],
-        "docs": "Enable the edge-to-edge mode.\n\nOnly available on Android.",
+        "docs": "Disable the edge-to-edge mode.\n\nOnly available on Android.",
         "complexTypes": [],
-        "slug": "enable"
+        "slug": "disable"
       },
       {
-        "name": "disable",
+        "name": "enable",
         "signature": "() => Promise<void>",
         "parameters": [],
         "returns": "Promise<void>",
@@ -31,9 +31,9 @@
             "text": "7.2.0"
           }
         ],
-        "docs": "Disable the edge-to-edge mode.\n\nOnly available on Android.",
+        "docs": "Enable the edge-to-edge mode.\n\nOnly available on Android.",
         "complexTypes": [],
-        "slug": "disable"
+        "slug": "enable"
       },
       {
         "name": "getInsets",
@@ -64,6 +64,10 @@
         ],
         "returns": "Promise<void>",
         "tags": [
+          {
+            "name": "deprecated",
+            "text": "Use `setStatusBarColor()` and `setNavigationBarColor()` instead."
+          },
           {
             "name": "since",
             "text": "7.0.0"
@@ -74,6 +78,52 @@
           "SetBackgroundColorOptions"
         ],
         "slug": "setbackgroundcolor"
+      },
+      {
+        "name": "setNavigationBarColor",
+        "signature": "(options: SetNavigationBarColorOptions) => Promise<void>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "SetNavigationBarColorOptions"
+          }
+        ],
+        "returns": "Promise<void>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "8.0.0"
+          }
+        ],
+        "docs": "Set the background color of the navigation bar area.\n\nOnly available on Android.",
+        "complexTypes": [
+          "SetNavigationBarColorOptions"
+        ],
+        "slug": "setnavigationbarcolor"
+      },
+      {
+        "name": "setStatusBarColor",
+        "signature": "(options: SetStatusBarColorOptions) => Promise<void>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "SetStatusBarColorOptions"
+          }
+        ],
+        "returns": "Promise<void>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "8.0.0"
+          }
+        ],
+        "docs": "Set the background color of the status bar area.\n\nOnly available on Android.",
+        "complexTypes": [
+          "SetStatusBarColorOptions"
+        ],
+        "slug": "setstatusbarcolor"
       }
     ],
     "properties": []
@@ -174,6 +224,66 @@
           "type": "string"
         }
       ]
+    },
+    {
+      "name": "SetNavigationBarColorOptions",
+      "slug": "setnavigationbarcoloroptions",
+      "docs": "",
+      "tags": [
+        {
+          "text": "8.0.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "color",
+          "tags": [
+            {
+              "text": "8.0.0",
+              "name": "since"
+            },
+            {
+              "text": "\"#000000\"",
+              "name": "example"
+            }
+          ],
+          "docs": "The hexadecimal color to set as the background color of the navigation bar area.",
+          "complexTypes": [],
+          "type": "string"
+        }
+      ]
+    },
+    {
+      "name": "SetStatusBarColorOptions",
+      "slug": "setstatusbarcoloroptions",
+      "docs": "",
+      "tags": [
+        {
+          "text": "8.0.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "color",
+          "tags": [
+            {
+              "text": "8.0.0",
+              "name": "since"
+            },
+            {
+              "text": "\"#ffffff\"",
+              "name": "example"
+            }
+          ],
+          "docs": "The hexadecimal color to set as the background color of the status bar area.",
+          "complexTypes": [],
+          "type": "string"
+        }
+      ]
     }
   ],
   "enums": [],
@@ -186,6 +296,10 @@
         {
           "name": "backgroundColor",
           "tags": [
+            {
+              "text": "Use `statusBarColor` and `navigationBarColor` instead.",
+              "name": "deprecated"
+            },
             {
               "text": "7.1.0",
               "name": "since"
@@ -198,6 +312,38 @@
           "docs": "The hexadecimal color to set as the background color of the status bar and navigation bar.",
           "complexTypes": [],
           "type": "string | undefined"
+        },
+        {
+          "name": "navigationBarColor",
+          "tags": [
+            {
+              "text": "8.0.0",
+              "name": "since"
+            },
+            {
+              "text": "\"#000000\"",
+              "name": "example"
+            }
+          ],
+          "docs": "The hexadecimal color to set as the background color of the navigation bar area.\n\nOnly available on Android.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "statusBarColor",
+          "tags": [
+            {
+              "text": "8.0.0",
+              "name": "since"
+            },
+            {
+              "text": "\"#ffffff\"",
+              "name": "example"
+            }
+          ],
+          "docs": "The hexadecimal color to set as the background color of the status bar area.\n\nOnly available on Android.",
+          "complexTypes": [],
+          "type": "string | undefined"
         }
       ],
       "docs": ""

package/dist/esm/definitions.d.ts

@@ -4,30 +4,49 @@ declare module '@capacitor/cli' {
             /**
              * The hexadecimal color to set as the background color of the status bar and navigation bar.
              *
+             * @deprecated Use `statusBarColor` and `navigationBarColor` instead.
              * @since 7.1.0
              * @example "#ffffff"
              */
             backgroundColor?: string;
+            /**
+             * The hexadecimal color to set as the background color of the navigation bar area.
+             *
+             * Only available on Android.
+             *
+             * @since 8.0.0
+             * @example "#000000"
+             */
+            navigationBarColor?: string;
+            /**
+             * The hexadecimal color to set as the background color of the status bar area.
+             *
+             * Only available on Android.
+             *
+             * @since 8.0.0
+             * @example "#ffffff"
+             */
+            statusBarColor?: string;
         };
     }
 }
 export interface EdgeToEdgePlugin {
     /**
-     * Enable the edge-to-edge mode.
+     * Disable the edge-to-edge mode.
      *
      * Only available on Android.
      *
      * @since 7.2.0
      */
-    enable(): Promise<void>;
+    disable(): Promise<void>;
     /**
-     * Disable the edge-to-edge mode.
+     * Enable the edge-to-edge mode.
      *
      * Only available on Android.
      *
      * @since 7.2.0
      */
-    disable(): Promise<void>;
+    enable(): Promise<void>;
     /**
      * Return the insets that are currently applied to the webview.
      *
@@ -41,9 +60,26 @@ export interface EdgeToEdgePlugin {
      *
      * Only available on Android.
      *
+     * @deprecated Use `setStatusBarColor()` and `setNavigationBarColor()` instead.
      * @since 7.0.0
      */
     setBackgroundColor(options: SetBackgroundColorOptions): Promise<void>;
+    /**
+     * Set the background color of the navigation bar area.
+     *
+     * Only available on Android.
+     *
+     * @since 8.0.0
+     */
+    setNavigationBarColor(options: SetNavigationBarColorOptions): Promise<void>;
+    /**
+     * Set the background color of the status bar area.
+     *
+     * Only available on Android.
+     *
+     * @since 8.0.0
+     */
+    setStatusBarColor(options: SetStatusBarColorOptions): Promise<void>;
 }
 /**
  * @since 7.2.0
@@ -95,3 +131,27 @@ export interface SetBackgroundColorOptions {
      */
     color: string;
 }
+/**
+ * @since 8.0.0
+ */
+export interface SetNavigationBarColorOptions {
+    /**
+     * The hexadecimal color to set as the background color of the navigation bar area.
+     *
+     * @since 8.0.0
+     * @example "#000000"
+     */
+    color: string;
+}
+/**
+ * @since 8.0.0
+ */
+export interface SetStatusBarColorOptions {
+    /**
+     * The hexadecimal color to set as the background color of the status bar area.
+     *
+     * @since 8.0.0
+     * @example "#ffffff"
+     */
+    color: string;
+}

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    EdgeToEdge?: {\n      /**\n       * The hexadecimal color to set as the background color of the status bar and navigation bar.\n       *\n       * @since 7.1.0\n       * @example \"#ffffff\"\n       */\n      backgroundColor?: string;\n    };\n  }\n}\n\nexport interface EdgeToEdgePlugin {\n  /**\n   * Enable the edge-to-edge mode.\n   *\n   * Only available on Android.\n   *\n   * @since 7.2.0\n   */\n  enable(): Promise<void>;\n  /**\n   * Disable the edge-to-edge mode.\n   *\n   * Only available on Android.\n   *\n   * @since 7.2.0\n   */\n  disable(): Promise<void>;\n  /**\n   * Return the insets that are currently applied to the webview.\n   *\n   * Only available on Android.\n   *\n   * @since 7.2.0\n   */\n  getInsets(): Promise<GetInsetsResult>;\n  /**\n   * Set the background color of the status bar and navigation bar.\n   *\n   * Only available on Android.\n   *\n   * @since 7.0.0\n   */\n  setBackgroundColor(options: SetBackgroundColorOptions): Promise<void>;\n}\n\n/**\n * @since 7.2.0\n */\nexport interface GetInsetsResult {\n  /**\n   * The bottom inset that was applied to the webview.\n   *\n   * Only available on Android.\n   *\n   * @since 7.2.0\n   */\n  bottom: number;\n  /**\n   * The left inset that was applied to the webview.\n   *\n   * Only available on Android.\n   *\n   * @since 7.2.0\n   */\n  left: number;\n  /**\n   * The right inset that was applied to the webview.\n   *\n   * Only available on Android.\n   *\n   * @since 7.2.0\n   */\n  right: number;\n  /**\n   * The top inset that was applied to the webview.\n   *\n   * Only available on Android.\n   *\n   * @since 7.2.0\n   */\n  top: number;\n}\n\n/**\n * @since 7.0.0\n */\nexport interface SetBackgroundColorOptions {\n  /**\n   * The hexadecimal color to set as the background color of the status bar and navigation bar.\n   *\n   * @since 7.0.0\n   * @example \"#ffffff\"\n   * @example \"#000000\"\n   */\n  color: string;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    EdgeToEdge?: {\n      /**\n       * The hexadecimal color to set as the background color of the status bar and navigation bar.\n       *\n       * @deprecated Use `statusBarColor` and `navigationBarColor` instead.\n       * @since 7.1.0\n       * @example \"#ffffff\"\n       */\n      backgroundColor?: string;\n      /**\n       * The hexadecimal color to set as the background color of the navigation bar area.\n       *\n       * Only available on Android.\n       *\n       * @since 8.0.0\n       * @example \"#000000\"\n       */\n      navigationBarColor?: string;\n      /**\n       * The hexadecimal color to set as the background color of the status bar area.\n       *\n       * Only available on Android.\n       *\n       * @since 8.0.0\n       * @example \"#ffffff\"\n       */\n      statusBarColor?: string;\n    };\n  }\n}\n\nexport interface EdgeToEdgePlugin {\n  /**\n   * Disable the edge-to-edge mode.\n   *\n   * Only available on Android.\n   *\n   * @since 7.2.0\n   */\n  disable(): Promise<void>;\n  /**\n   * Enable the edge-to-edge mode.\n   *\n   * Only available on Android.\n   *\n   * @since 7.2.0\n   */\n  enable(): Promise<void>;\n  /**\n   * Return the insets that are currently applied to the webview.\n   *\n   * Only available on Android.\n   *\n   * @since 7.2.0\n   */\n  getInsets(): Promise<GetInsetsResult>;\n  /**\n   * Set the background color of the status bar and navigation bar.\n   *\n   * Only available on Android.\n   *\n   * @deprecated Use `setStatusBarColor()` and `setNavigationBarColor()` instead.\n   * @since 7.0.0\n   */\n  setBackgroundColor(options: SetBackgroundColorOptions): Promise<void>;\n  /**\n   * Set the background color of the navigation bar area.\n   *\n   * Only available on Android.\n   *\n   * @since 8.0.0\n   */\n  setNavigationBarColor(options: SetNavigationBarColorOptions): Promise<void>;\n  /**\n   * Set the background color of the status bar area.\n   *\n   * Only available on Android.\n   *\n   * @since 8.0.0\n   */\n  setStatusBarColor(options: SetStatusBarColorOptions): Promise<void>;\n}\n\n/**\n * @since 7.2.0\n */\nexport interface GetInsetsResult {\n  /**\n   * The bottom inset that was applied to the webview.\n   *\n   * Only available on Android.\n   *\n   * @since 7.2.0\n   */\n  bottom: number;\n  /**\n   * The left inset that was applied to the webview.\n   *\n   * Only available on Android.\n   *\n   * @since 7.2.0\n   */\n  left: number;\n  /**\n   * The right inset that was applied to the webview.\n   *\n   * Only available on Android.\n   *\n   * @since 7.2.0\n   */\n  right: number;\n  /**\n   * The top inset that was applied to the webview.\n   *\n   * Only available on Android.\n   *\n   * @since 7.2.0\n   */\n  top: number;\n}\n\n/**\n * @since 7.0.0\n */\nexport interface SetBackgroundColorOptions {\n  /**\n   * The hexadecimal color to set as the background color of the status bar and navigation bar.\n   *\n   * @since 7.0.0\n   * @example \"#ffffff\"\n   * @example \"#000000\"\n   */\n  color: string;\n}\n\n/**\n * @since 8.0.0\n */\nexport interface SetNavigationBarColorOptions {\n  /**\n   * The hexadecimal color to set as the background color of the navigation bar area.\n   *\n   * @since 8.0.0\n   * @example \"#000000\"\n   */\n  color: string;\n}\n\n/**\n * @since 8.0.0\n */\nexport interface SetStatusBarColorOptions {\n  /**\n   * The hexadecimal color to set as the background color of the status bar area.\n   *\n   * @since 8.0.0\n   * @example \"#ffffff\"\n   */\n  color: string;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capawesome/capacitor-android-edge-to-edge-support",
-  "version": "7.2.3",
+  "version": "8.0.1",
   "description": "Capacitor plugin to support edge-to-edge display on Android.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -50,18 +50,18 @@
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
-    "@capacitor/android": "7.0.0",
-    "@capacitor/cli": "7.0.0",
-    "@capacitor/core": "7.0.0",
-    "@capacitor/docgen": "0.3.0",
+    "@capacitor/android": "8.0.0",
+    "@capacitor/cli": "8.0.0",
+    "@capacitor/core": "8.0.0",
+    "@capacitor/docgen": "0.3.1",
     "prettier": "3.4.2",
     "prettier-plugin-java": "2.6.7",
-    "rimraf": "6.0.1",
-    "rollup": "4.30.1",
-    "typescript": "4.1.5"
+    "rimraf": "6.1.2",
+    "rollup": "4.53.3",
+    "typescript": "5.9.3"
   },
   "peerDependencies": {
-    "@capacitor/core": ">=7.0.0"
+    "@capacitor/core": ">=8.0.0"
   },
   "capacitor": {
     "android": {