@maximilien0405/capacitor-android-launcher 0.0.3 → 7.0.1

package/README.md

@@ -2,7 +2,13 @@
 
 This Capacitor plugin allows you to open the launcher settings to set your app as the default launcher on Android. 
 
-It can also, if needed, start (and stop) and immersive mode that hides all UI elements and prevents your user from leaving the app. This is usefull for an Kiosk App, or for children or seniors.
+It can also, if needed, start (and stop) and immersive mode that hides the all UI elements (status bar and navigation bar). This is usefull for an Kiosk App, or for special apps made for childrens or seniors.
+
+## Support
+
+ANDROID Only.
+
+- v7.X.X supports Capacitor V7 (Android minSdkVersion 23+).
 
 ## Installation
 
@@ -14,7 +20,7 @@ npx cap sync
 ## Usage
 
 
-#### Request Launcher Role
+#### Open Launcher Settings
 
 This method opens the settings page where the user can set your app as the default launcher.
 
@@ -24,7 +30,7 @@ await AndroidLauncher.openLauncherSettings();
 
 #### Start Immersive Mode
 
-This method hides all system controls and prevents the user from leaving the app.
+This method hides all system controls.
 
 > ⚠️ The app must be set as the launcher for it to work.
 
@@ -34,28 +40,17 @@ await AndroidLauncher.startImmersiveMode();
 
 #### Stop Immersive Mode
 
-This method restores the system controls and allows the user to exit the app.
+This method restores the system controls.
 
 ```ts
 await AndroidLauncher.stopImmersiveMode();
 ```
 
-#### Check if the App is the Launcher
+#### Check if is the Launcher
 
 This method checks if your app is currently set as the default launcher.
 
 ```ts
 const isLauncher = await AndroidLauncher.isLauncherApp();
 console.log(isLauncher);  // true or false
-```
-
-## API
-
-```ts
-interface AndroidLauncherPlugin {
-  openLauncherSettings(): Promise<void>;
-  startImmersiveMode(): Promise<void>;
-  stopImmersiveMode(): Promise<void>;
-  isLauncherApp(): Promise<boolean>;
-}
 ```

package/android/src/main/java/com/maximilien0405/androidlauncher/AndroidLauncher.java

@@ -1,25 +1,30 @@
 package com.maximilien0405.androidlauncher;
 
-import android.view.View;
 import android.content.Intent;
-import android.provider.Settings;
 import android.content.pm.PackageManager;
 import android.content.pm.ResolveInfo;
-import android.widget.Toast;
+import android.os.Handler;
+import android.os.Build;
+import android.os.Looper;
+import android.view.View;
+import android.view.WindowInsetsController;
 import androidx.appcompat.app.AppCompatActivity;
-
-import com.getcapacitor.JSObject;
+import androidx.annotation.RequiresApi;
 import com.getcapacitor.Plugin;
 import com.getcapacitor.PluginCall;
-import com.getcapacitor.annotation.CapacitorPlugin;
 import com.getcapacitor.PluginMethod;
+import com.getcapacitor.Bridge;
+import android.provider.Settings;
 
 public class AndroidLauncher {
-
     private AppCompatActivity activity;
+    private Bridge bridge;
+    private boolean immersiveModeEnabled = false;
 
-    public AndroidLauncher(AppCompatActivity activity) {
-        this.activity = activity;
+    public AndroidLauncher(AppCompatActivity activity, Bridge bridge) {
+      this.activity = activity;
+      this.bridge = bridge;
+      setupSystemUiVisibilityListener();
     }
 
     // Opens the settings to allow the user to set the app as launcher
@@ -35,32 +40,88 @@ public class AndroidLauncher {
 
     // Starts immersive mode and prevents the user from leaving the app (if it's the launcher)
     public void startImmersiveMode(PluginCall call) {
-        if (!isLauncherApp()) {
-            call.reject("App is not set as the launcher.");
-            return;
-        }
-
         try {
-            // Hide the status bar and navigation bar
-            activity.getWindow().getDecorView().setSystemUiVisibility(
-                View.SYSTEM_UI_FLAG_IMMERSIVE |
-                View.SYSTEM_UI_FLAG_FULLSCREEN |
-                View.SYSTEM_UI_FLAG_HIDE_NAVIGATION);
-            call.resolve();
+            if (Looper.myLooper() == Looper.getMainLooper()) {
+                enableImmersiveMode();
+                call.resolve();
+            } else {
+                new Handler(Looper.getMainLooper()).post(new Runnable() {
+                    @Override
+                    public void run() {
+                        enableImmersiveMode();
+                        call.resolve();
+                    }
+                });
+            }
         } catch (Exception e) {
             call.reject("Error starting immersive mode", e);
         }
     }
 
-    // Stops immersive mode and allows the user to interact with the controls again
+    private void enableImmersiveMode() {
+      try {
+        immersiveModeEnabled = true;
+        View decorView = this.bridge.getActivity().getWindow().getDecorView();
+        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.R) {
+          WindowInsetsController insetsController = decorView.getWindowInsetsController();
+          if (insetsController != null) {
+              insetsController.hide(android.view.WindowInsets.Type.statusBars()
+                                  | android.view.WindowInsets.Type.navigationBars());
+
+              insetsController.setSystemBarsBehavior(
+                  WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE);
+          }
+        } else {
+            int flags = View.SYSTEM_UI_FLAG_LAYOUT_STABLE
+                    | View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
+                    | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
+                    | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
+                    | View.SYSTEM_UI_FLAG_FULLSCREEN
+                    | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY;
+            decorView.setSystemUiVisibility(flags);
+        }
+      } catch (Exception e) {
+          e.printStackTrace();
+      }
+    }
+
     public void stopImmersiveMode(PluginCall call) {
+      try {
+          if (Looper.myLooper() == Looper.getMainLooper()) {
+              clearImmersiveMode();
+              call.resolve();
+          } else {
+              new Handler(Looper.getMainLooper()).post(new Runnable() {
+                  @Override
+                  public void run() {
+                      clearImmersiveMode();
+                      call.resolve();
+                  }
+              });
+          }
+      } catch (Exception e) {
+          call.reject("Error stopping immersive mode", e);
+      }
+    }
+
+    private void clearImmersiveMode() {
         try {
-            // Reset system UI visibility
-            activity.getWindow().getDecorView().setSystemUiVisibility(
-                View.SYSTEM_UI_FLAG_VISIBLE);
-            call.resolve();
+          immersiveModeEnabled = false;
+          View decorView = this.bridge.getActivity().getWindow().getDecorView();
+          if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
+              WindowInsetsController insetsController = decorView.getWindowInsetsController();
+              if (insetsController != null) {
+                  insetsController.hide(WindowInsetsController.BEHAVIOR_SHOW_BARS_BY_SWIPE);
+                  insetsController.setSystemBarsBehavior(WindowInsetsController.BEHAVIOR_SHOW_BARS_BY_TOUCH);
+              }
+          } else {
+              int uiOptions = View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY |
+                              View.SYSTEM_UI_FLAG_HIDE_NAVIGATION |
+                              View.SYSTEM_UI_FLAG_FULLSCREEN;
+              decorView.setSystemUiVisibility(uiOptions);
+          }
         } catch (Exception e) {
-            call.reject("Error stopping immersive mode", e);
+            e.printStackTrace();
         }
     }
 
@@ -72,4 +133,32 @@ public class AndroidLauncher {
         ResolveInfo resolveInfo = packageManager.resolveActivity(intent, PackageManager.MATCH_DEFAULT_ONLY);
         return resolveInfo.activityInfo.packageName.equals(activity.getPackageName());
     }
+
+    // Listen to system UI changes and hide UI if swiped
+    private void setupSystemUiVisibilityListener() {
+      if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.R) {
+        // For Android 11+, use a window focus change listener instead
+        activity.getWindow().getDecorView().setOnApplyWindowInsetsListener(
+            (view, windowInsets) -> {
+                if (immersiveModeEnabled &&
+                    windowInsets.isVisible(android.view.WindowInsets.Type.statusBars() | android.view.WindowInsets.Type.navigationBars())) {
+                    if (immersiveModeEnabled) {
+                      enableImmersiveMode();
+                    }
+                }
+                return view.onApplyWindowInsets(windowInsets);
+            });
+      } else {
+        // For older Android versions
+        activity.getWindow().getDecorView().setOnSystemUiVisibilityChangeListener(
+            visibility -> {
+                if (immersiveModeEnabled && (visibility & View.SYSTEM_UI_FLAG_FULLSCREEN) == 0) {
+                  if (immersiveModeEnabled) {
+                      enableImmersiveMode();
+                  }
+                }
+            }
+        );
+      }
+    }
 }

package/android/src/main/java/com/maximilien0405/androidlauncher/AndroidLauncherPlugin.java

@@ -14,7 +14,7 @@ public class AndroidLauncherPlugin extends Plugin {
     @Override
     public void load() {
         super.load();
-        androidLauncher = new AndroidLauncher(getActivity()); 
+        androidLauncher = new AndroidLauncher(getActivity(), getBridge());
     }
 
     // Opens the launcher settings

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maximilien0405/capacitor-android-launcher",
-  "version": "0.0.3",
+  "version": "7.0.1",
   "description": "Capacitor plugin to request your app to be the main launcher.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",