html2apk 0.3.0 → 0.4.0

package/src/desktop/renderer/styles.css

@@ -889,7 +889,12 @@ h2 {
   gap: 10px;
 }
 
-.code-card code {
+.code-card-top {
+  display: grid;
+  gap: 8px;
+}
+
+.code-card-top code {
   overflow-wrap: anywhere;
   color: #d6e4f7;
   background: #0c1117;
@@ -897,7 +902,7 @@ h2 {
   padding: 10px;
 }
 
-.code-card span {
+.code-card-top span {
   color: var(--blue);
   font-weight: 800;
 }
@@ -923,6 +928,59 @@ h2 {
   padding-top: 10px;
 }
 
+.copy-example {
+  border-top: 1px solid var(--line);
+  padding-top: 12px;
+  display: grid;
+  gap: 8px;
+}
+
+.copy-example-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 10px;
+}
+
+.copy-example-header strong {
+  font-size: .88rem;
+}
+
+.copy-code-button {
+  min-height: 34px;
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  padding: 0 12px;
+  background: var(--bg);
+  color: var(--blue);
+  font-weight: 800;
+  cursor: pointer;
+}
+
+.copy-code-button.copied {
+  color: var(--green);
+}
+
+.copy-code-button.copy-error {
+  color: var(--red);
+}
+
+.copy-example pre {
+  margin: 0;
+  max-height: 260px;
+  overflow: auto;
+  border-radius: 8px;
+  background: #0c1117;
+}
+
+.copy-example pre code {
+  display: block;
+  padding: 12px;
+  color: #d6e4f7;
+  font: 12px/1.55 Consolas, "Courier New", monospace;
+  white-space: pre;
+}
+
 .success-view {
   min-height: 100%;
   display: none;

package/src/templates/cordova-plugin-html2apk-bridge/src/android/Html2ApkBridge.java

@@ -14,6 +14,7 @@ import android.content.ClipboardManager;
 import android.content.Context;
 import android.content.Intent;
 import android.content.IntentFilter;
+import android.content.SharedPreferences;
 import android.content.pm.ApplicationInfo;
 import android.content.pm.PackageManager;
 import android.database.Cursor;
@@ -70,17 +71,25 @@ public class Html2ApkBridge extends CordovaPlugin {
     private static final int REQUEST_PICK_FILE = 7411;
     private static final int REQUEST_SAVE_FILE = 7412;
     private static final int REQUEST_PICK_FOLDER = 7413;
+    private static final String PREFS_NAME = "html2apk_bridge";
+    private static final String PREF_PERMISSION_PREFIX = "permission_requested_";
 
     private CallbackContext notificationPermissionCallback;
     private CallbackContext cameraPermissionCallback;
+    private CallbackContext pendingNotificationCallback;
+    private CallbackContext pendingFlashlightCallback;
     private CallbackContext microphonePermissionCallback;
     private CallbackContext pendingMicStartCallback;
     private CallbackContext filePickerCallback;
     private CallbackContext saveFileCallback;
     private CallbackContext folderPickerCallback;
     private JSONObject pendingSaveFile;
+    private JSONObject pendingNotificationOptions;
     private JSONObject initialNotification;
     private JSONObject initialLink;
+    private Boolean pendingFlashlightEnabled;
+    private boolean pendingNotificationSchedule;
+    private boolean pendingFlashlightToggle;
     private boolean overlaySettingsOpened;
     private boolean torchEnabled;
     private MediaRecorder micRecorder;
@@ -130,6 +139,9 @@ public class Html2ApkBridge extends CordovaPlugin {
         try {
             if ("notify".equals(action)) {
                 JSONObject options = args.optJSONObject(0);
+                if (requestNotificationPermissionForAction(options == null ? new JSONObject() : options, false, callbackContext)) {
+                    return true;
+                }
                 showNotification(options == null ? new JSONObject() : options);
                 callbackContext.success();
                 return true;
@@ -137,6 +149,9 @@ public class Html2ApkBridge extends CordovaPlugin {
 
             if ("scheduleNotification".equals(action)) {
                 JSONObject options = args.optJSONObject(0);
+                if (requestNotificationPermissionForAction(options == null ? new JSONObject() : options, true, callbackContext)) {
+                    return true;
+                }
                 callbackContext.success(scheduleNotification(options == null ? new JSONObject() : options));
                 return true;
             }
@@ -183,14 +198,12 @@ public class Html2ApkBridge extends CordovaPlugin {
             }
 
             if ("flashlight".equals(action)) {
-                setFlashlight(args.optBoolean(0, true));
-                callbackContext.success(flashlightStatus());
+                setFlashlightWithPermission(args.optBoolean(0, true), false, callbackContext);
                 return true;
             }
 
             if ("toggleFlashlight".equals(action)) {
-                setFlashlight(!torchEnabled);
-                callbackContext.success(flashlightStatus());
+                setFlashlightWithPermission(false, true, callbackContext);
                 return true;
             }
 
@@ -343,7 +356,14 @@ public class Html2ApkBridge extends CordovaPlugin {
 
             if ("openExactAlarmSettings".equals(action)) {
                 openExactAlarmSettings();
-                callbackContext.success();
+                JSONObject result = new JSONObject();
+                result.put("permission", "android.permission.SCHEDULE_EXACT_ALARM");
+                result.put("required", Build.VERSION.SDK_INT >= Build.VERSION_CODES.S);
+                result.put("granted", canScheduleExactAlarms());
+                result.put("permissionGranted", canScheduleExactAlarms());
+                result.put("requiresSettings", Build.VERSION.SDK_INT >= Build.VERSION_CODES.S && !canScheduleExactAlarms());
+                result.put("settingsOpened", Build.VERSION.SDK_INT >= Build.VERSION_CODES.S && !canScheduleExactAlarms());
+                callbackContext.success(result);
                 return true;
             }
 
@@ -354,11 +374,22 @@ public class Html2ApkBridge extends CordovaPlugin {
 
             if ("requestOverlayPermission".equals(action) || "openOverlaySettings".equals(action)) {
                 openOverlaySettings();
-                callbackContext.success(overlayPermissionStatus());
+                JSONObject result = overlayPermissionStatus();
+                result.put("requested", true);
+                result.put("settingsOpened", result.optBoolean("requiresSettings"));
+                callbackContext.success(result);
                 return true;
             }
 
             if ("startFloatingIcon".equals(action)) {
+                if (!canDrawOverlays()) {
+                    openOverlaySettings();
+                    JSONObject result = overlayPermissionStatus();
+                    result.put("requested", true);
+                    result.put("requiresSettings", true);
+                    callbackContext.success(result);
+                    return true;
+                }
                 startFloatingIcon();
                 callbackContext.success(overlayPermissionStatus());
                 return true;
@@ -391,14 +422,50 @@ public class Html2ApkBridge extends CordovaPlugin {
 
     @Override
     public void onRequestPermissionResult(int requestCode, String[] permissions, int[] grantResults) {
-        if (requestCode == REQUEST_CAMERA && cameraPermissionCallback != null) {
+        if (requestCode == REQUEST_CAMERA) {
             boolean granted = grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED;
+            if (pendingFlashlightCallback != null) {
+                CallbackContext callback = pendingFlashlightCallback;
+                Boolean enabled = pendingFlashlightEnabled;
+                boolean toggle = pendingFlashlightToggle;
+                pendingFlashlightCallback = null;
+                pendingFlashlightEnabled = null;
+                pendingFlashlightToggle = false;
+
+                try {
+                    if (!granted) {
+                        JSONObject result = shouldOpenSettingsForRuntimePermission(Manifest.permission.CAMERA)
+                            ? openSettingsForRuntimePermission(Manifest.permission.CAMERA, true, true)
+                            : flashlightStatus();
+                        result.put("requested", true);
+                        result.put("granted", false);
+                        callback.success(result);
+                        return;
+                    }
+
+                    setFlashlight(toggle ? !torchEnabled : Boolean.TRUE.equals(enabled));
+                    JSONObject result = flashlightStatus();
+                    result.put("requested", true);
+                    result.put("granted", true);
+                    callback.success(result);
+                } catch (Exception error) {
+                    callback.error(error.getMessage());
+                }
+                return;
+            }
+
+            if (cameraPermissionCallback == null) {
+                return;
+            }
+
             try {
-                JSONObject result = new JSONObject();
-                result.put("permission", "android.permission.CAMERA");
-                result.put("required", true);
-                result.put("requested", true);
-                result.put("granted", granted);
+                JSONObject result = granted
+                    ? runtimePermissionResult(Manifest.permission.CAMERA, true, true, true)
+                    : (
+                        shouldOpenSettingsForRuntimePermission(Manifest.permission.CAMERA)
+                            ? openSettingsForRuntimePermission(Manifest.permission.CAMERA, true, true)
+                            : runtimePermissionResult(Manifest.permission.CAMERA, true, true, false)
+                    );
                 cameraPermissionCallback.success(result);
             } catch (Exception error) {
                 cameraPermissionCallback.error(error.getMessage());
@@ -423,7 +490,13 @@ public class Html2ApkBridge extends CordovaPlugin {
                 if (shouldStartRecording && granted) {
                     startMicRecorder(callback);
                 } else {
-                    JSONObject result = microphoneStatus();
+                    JSONObject result = granted
+                        ? microphoneStatus()
+                        : (
+                            shouldOpenSettingsForRuntimePermission(Manifest.permission.RECORD_AUDIO)
+                                ? openSettingsForRuntimePermission(Manifest.permission.RECORD_AUDIO, true, true)
+                                : microphoneStatus()
+                        );
                     result.put("requested", true);
                     result.put("granted", granted);
                     callback.success(result);
@@ -434,13 +507,57 @@ public class Html2ApkBridge extends CordovaPlugin {
             return;
         }
 
-        if (requestCode != REQUEST_POST_NOTIFICATIONS || notificationPermissionCallback == null) {
+        if (requestCode != REQUEST_POST_NOTIFICATIONS) {
             return;
         }
 
         boolean granted = grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED;
+        if (pendingNotificationCallback != null) {
+            CallbackContext callback = pendingNotificationCallback;
+            JSONObject options = pendingNotificationOptions == null ? new JSONObject() : pendingNotificationOptions;
+            boolean schedule = pendingNotificationSchedule;
+            pendingNotificationCallback = null;
+            pendingNotificationOptions = null;
+            pendingNotificationSchedule = false;
+
+            try {
+                if (!granted) {
+                    JSONObject result = shouldOpenSettingsForRuntimePermission(Manifest.permission.POST_NOTIFICATIONS)
+                        ? openSettingsForRuntimePermission(Manifest.permission.POST_NOTIFICATIONS, true, true)
+                        : notificationPermissionStatus();
+                    result.put("requested", true);
+                    result.put("granted", false);
+                    callback.success(result);
+                    return;
+                }
+
+                if (schedule) {
+                    JSONObject result = scheduleNotification(options);
+                    result.put("requested", true);
+                    result.put("granted", true);
+                    callback.success(result);
+                } else {
+                    showNotification(options);
+                    callback.success();
+                }
+            } catch (Exception error) {
+                callback.error(error.getMessage());
+            }
+            return;
+        }
+
+        if (notificationPermissionCallback == null) {
+            return;
+        }
+
         try {
-            JSONObject result = notificationPermissionStatus();
+            JSONObject result = granted
+                ? notificationPermissionStatus()
+                : (
+                    shouldOpenSettingsForRuntimePermission(Manifest.permission.POST_NOTIFICATIONS)
+                        ? openSettingsForRuntimePermission(Manifest.permission.POST_NOTIFICATIONS, true, true)
+                        : notificationPermissionStatus()
+                );
             result.put("requested", true);
             result.put("granted", granted);
             notificationPermissionCallback.success(result);
@@ -472,6 +589,78 @@ public class Html2ApkBridge extends CordovaPlugin {
         return this.cordova.getActivity().getApplicationContext();
     }
 
+    private SharedPreferences preferencesStore() {
+        return context().getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE);
+    }
+
+    private boolean wasRuntimePermissionRequested(String permission) {
+        return preferencesStore().getBoolean(PREF_PERMISSION_PREFIX + permission, false);
+    }
+
+    private void rememberRuntimePermissionRequest(String permission) {
+        preferencesStore().edit().putBoolean(PREF_PERMISSION_PREFIX + permission, true).apply();
+    }
+
+    private boolean shouldOpenSettingsForRuntimePermission(String permission) {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M || !wasRuntimePermissionRequested(permission)) {
+            return false;
+        }
+
+        return !cordova.getActivity().shouldShowRequestPermissionRationale(permission);
+    }
+
+    private JSONObject runtimePermissionResult(String permission, boolean required, boolean requested, boolean granted) throws Exception {
+        JSONObject result = new JSONObject();
+        result.put("permission", permission);
+        result.put("required", required);
+        result.put("requested", requested);
+        result.put("granted", granted);
+        result.put("permissionGranted", granted);
+        result.put("requiresSettings", required && !granted && shouldOpenSettingsForRuntimePermission(permission));
+        result.put("settingsOpened", false);
+        return result;
+    }
+
+    private JSONObject openSettingsForRuntimePermission(String permission, boolean required, boolean requested) throws Exception {
+        JSONObject result = runtimePermissionResult(permission, required, requested, false);
+        openPermissionSettings(permission);
+        result.put("requiresSettings", true);
+        result.put("settingsOpened", true);
+        result.put("settingsScreen", Manifest.permission.POST_NOTIFICATIONS.equals(permission) ? "notifications" : "app");
+        result.put("telaConfiguracao", result.optString("settingsScreen"));
+        return result;
+    }
+
+    private void openPermissionSettings(String permission) {
+        if (Manifest.permission.POST_NOTIFICATIONS.equals(permission)) {
+            openNotificationSettings();
+            return;
+        }
+
+        openAppSettings();
+    }
+
+    private void openAppSettings() {
+        Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
+        intent.setData(Uri.parse("package:" + context().getPackageName()));
+        cordova.getActivity().startActivity(intent);
+    }
+
+    private void openNotificationSettings() {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) {
+            openAppSettings();
+            return;
+        }
+
+        Intent intent = new Intent(Settings.ACTION_APP_NOTIFICATION_SETTINGS);
+        intent.putExtra(Settings.EXTRA_APP_PACKAGE, context().getPackageName());
+        try {
+            cordova.getActivity().startActivity(intent);
+        } catch (ActivityNotFoundException error) {
+            openAppSettings();
+        }
+    }
+
     private boolean isFloatingMode() {
         return "floating".equals(preferences.getString("Html2ApkMode", ""));
     }
@@ -507,17 +696,24 @@ public class Html2ApkBridge extends CordovaPlugin {
         result.put("required", Build.VERSION.SDK_INT >= Build.VERSION_CODES.M);
         result.put("granted", canDrawOverlays());
         result.put("permission", "android.permission.SYSTEM_ALERT_WINDOW");
+        result.put("permissionGranted", canDrawOverlays());
+        result.put("requiresSettings", Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && !canDrawOverlays());
+        result.put("settingsOpened", false);
         return result;
     }
 
     private void openOverlaySettings() {
-        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M || canDrawOverlays()) {
             return;
         }
 
         Intent intent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION);
         intent.setData(Uri.parse("package:" + context().getPackageName()));
-        cordova.getActivity().startActivity(intent);
+        try {
+            cordova.getActivity().startActivity(intent);
+        } catch (ActivityNotFoundException error) {
+            openAppSettings();
+        }
     }
 
     private void startFloatingIcon() throws Exception {
@@ -561,21 +757,42 @@ public class Html2ApkBridge extends CordovaPlugin {
             return;
         }
 
+        if (shouldOpenSettingsForRuntimePermission(Manifest.permission.POST_NOTIFICATIONS)) {
+            callbackContext.success(openSettingsForRuntimePermission(Manifest.permission.POST_NOTIFICATIONS, true, false));
+            return;
+        }
+
         notificationPermissionCallback = callbackContext;
+        rememberRuntimePermissionRequest(Manifest.permission.POST_NOTIFICATIONS);
         cordova.requestPermission(this, REQUEST_POST_NOTIFICATIONS, Manifest.permission.POST_NOTIFICATIONS);
     }
 
     private JSONObject notificationPermissionStatus() throws Exception {
-        JSONObject result = new JSONObject();
-        result.put("required", Build.VERSION.SDK_INT >= 33);
-        result.put("granted", hasNotificationPermission());
-        result.put("permission", "android.permission.POST_NOTIFICATIONS");
-        return result;
+        boolean required = Build.VERSION.SDK_INT >= 33;
+        return runtimePermissionResult(Manifest.permission.POST_NOTIFICATIONS, required, false, hasNotificationPermission());
+    }
+
+    private boolean requestNotificationPermissionForAction(JSONObject options, boolean schedule, CallbackContext callbackContext) throws Exception {
+        if (hasNotificationPermission()) {
+            return false;
+        }
+
+        if (shouldOpenSettingsForRuntimePermission(Manifest.permission.POST_NOTIFICATIONS)) {
+            callbackContext.success(openSettingsForRuntimePermission(Manifest.permission.POST_NOTIFICATIONS, true, false));
+            return true;
+        }
+
+        pendingNotificationOptions = options;
+        pendingNotificationSchedule = schedule;
+        pendingNotificationCallback = callbackContext;
+        rememberRuntimePermissionRequest(Manifest.permission.POST_NOTIFICATIONS);
+        cordova.requestPermission(this, REQUEST_POST_NOTIFICATIONS, Manifest.permission.POST_NOTIFICATIONS);
+        return true;
     }
 
     private void showNotification(JSONObject options) throws Exception {
         if (!hasNotificationPermission()) {
-            throw new Exception("POST_NOTIFICATIONS permission is not granted. Call solicitarPermissaoNotificacoes() first.");
+            throw new Exception("POST_NOTIFICATIONS permission is not granted.");
         }
 
         ensureNotificationChannel(context());
@@ -607,8 +824,15 @@ public class Html2ApkBridge extends CordovaPlugin {
         options.put("id", id);
         options.put("quando", when);
         options.put("when", when);
+        boolean exactRequested = wantsExactAlarm(options);
+        boolean exactAllowed = canScheduleExactAlarms();
+        boolean settingsOpened = false;
+        if (exactRequested && !exactAllowed) {
+            openExactAlarmSettings();
+            settingsOpened = true;
+        }
         NotificationStore.save(context(), id, when, options);
-        NotificationReceiver.schedule(context(), id, when, options, canScheduleExactAlarms());
+        NotificationReceiver.schedule(context(), id, when, options, exactAllowed);
 
         JSONObject result = new JSONObject();
         result.put("id", id);
@@ -616,9 +840,24 @@ public class Html2ApkBridge extends CordovaPlugin {
         result.put("quando", when);
         result.put("repeating", repeatInterval(options) > 0);
         result.put("loop", loopNotifications(options).length() > 0);
+        result.put("exactRequested", exactRequested);
+        result.put("exatoSolicitado", exactRequested);
+        result.put("exactAllowed", exactAllowed);
+        result.put("exatoPermitido", exactAllowed);
+        result.put("requiresSettings", exactRequested && !exactAllowed);
+        result.put("settingsOpened", settingsOpened);
         return result;
     }
 
+    private boolean wantsExactAlarm(JSONObject options) {
+        return options.optBoolean("exato",
+            options.optBoolean("exact",
+                options.optBoolean("alarmeExato",
+                    options.optBoolean("exactAlarm",
+                        options.optBoolean("preciso",
+                            options.optBoolean("precise", false))))));
+    }
+
     private void cancelNotification(Object input) throws Exception {
         int id = notificationIdFromObject(input);
         if (id == 0) {
@@ -635,14 +874,18 @@ public class Html2ApkBridge extends CordovaPlugin {
     }
 
     private void openExactAlarmSettings() {
-        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.S) {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.S || canScheduleExactAlarms()) {
             return;
         }
 
         Intent intent = new Intent(Settings.ACTION_REQUEST_SCHEDULE_EXACT_ALARM);
         intent.setData(Uri.parse("package:" + context().getPackageName()));
         intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
-        context().startActivity(intent);
+        try {
+            context().startActivity(intent);
+        } catch (ActivityNotFoundException error) {
+            openAppSettings();
+        }
     }
 
     private void vibrate(long ms) {
@@ -822,15 +1065,17 @@ public class Html2ApkBridge extends CordovaPlugin {
 
     private void requestCameraPermission(CallbackContext callbackContext) throws Exception {
         if (hasCameraPermission()) {
-            JSONObject result = new JSONObject();
-            result.put("permission", "android.permission.CAMERA");
-            result.put("required", true);
-            result.put("granted", true);
-            callbackContext.success(result);
+            callbackContext.success(runtimePermissionResult(Manifest.permission.CAMERA, true, false, true));
+            return;
+        }
+
+        if (shouldOpenSettingsForRuntimePermission(Manifest.permission.CAMERA)) {
+            callbackContext.success(openSettingsForRuntimePermission(Manifest.permission.CAMERA, true, false));
             return;
         }
 
         cameraPermissionCallback = callbackContext;
+        rememberRuntimePermissionRequest(Manifest.permission.CAMERA);
         cordova.requestPermission(this, REQUEST_CAMERA, Manifest.permission.CAMERA);
     }
 
@@ -847,7 +1092,13 @@ public class Html2ApkBridge extends CordovaPlugin {
             return;
         }
 
+        if (shouldOpenSettingsForRuntimePermission(Manifest.permission.RECORD_AUDIO)) {
+            callbackContext.success(openSettingsForRuntimePermission(Manifest.permission.RECORD_AUDIO, true, false));
+            return;
+        }
+
         microphonePermissionCallback = callbackContext;
+        rememberRuntimePermissionRequest(Manifest.permission.RECORD_AUDIO);
         cordova.requestPermission(this, REQUEST_RECORD_AUDIO, Manifest.permission.RECORD_AUDIO);
     }
 
@@ -857,6 +1108,8 @@ public class Html2ApkBridge extends CordovaPlugin {
         result.put("required", true);
         result.put("granted", hasMicrophonePermission());
         result.put("permissionGranted", hasMicrophonePermission());
+        result.put("requiresSettings", !hasMicrophonePermission() && shouldOpenSettingsForRuntimePermission(Manifest.permission.RECORD_AUDIO));
+        result.put("settingsOpened", false);
         result.put("recording", micRecorder != null);
         result.put("gravando", micRecorder != null);
         if (micRecorder != null) {
@@ -878,7 +1131,13 @@ public class Html2ApkBridge extends CordovaPlugin {
         }
 
         if (!hasMicrophonePermission()) {
+            if (shouldOpenSettingsForRuntimePermission(Manifest.permission.RECORD_AUDIO)) {
+                callbackContext.success(openSettingsForRuntimePermission(Manifest.permission.RECORD_AUDIO, true, false));
+                return;
+            }
+
             pendingMicStartCallback = callbackContext;
+            rememberRuntimePermissionRequest(Manifest.permission.RECORD_AUDIO);
             cordova.requestPermission(this, REQUEST_RECORD_AUDIO, Manifest.permission.RECORD_AUDIO);
             return;
         }
@@ -1046,7 +1305,7 @@ public class Html2ApkBridge extends CordovaPlugin {
 
     private void setFlashlight(boolean enabled) throws Exception {
         if (!hasCameraPermission()) {
-            throw new Exception("CAMERA permission is not granted. Call solicitarPermissaoCamera() first.");
+            throw new Exception("CAMERA permission is not granted.");
         }
 
         CameraManager manager = (CameraManager) context().getSystemService(Context.CAMERA_SERVICE);
@@ -1058,12 +1317,33 @@ public class Html2ApkBridge extends CordovaPlugin {
         torchEnabled = enabled;
     }
 
+    private void setFlashlightWithPermission(boolean enabled, boolean toggle, CallbackContext callbackContext) throws Exception {
+        if (!hasCameraPermission()) {
+            if (shouldOpenSettingsForRuntimePermission(Manifest.permission.CAMERA)) {
+                callbackContext.success(openSettingsForRuntimePermission(Manifest.permission.CAMERA, true, false));
+                return;
+            }
+
+            pendingFlashlightCallback = callbackContext;
+            pendingFlashlightEnabled = enabled;
+            pendingFlashlightToggle = toggle;
+            rememberRuntimePermissionRequest(Manifest.permission.CAMERA);
+            cordova.requestPermission(this, REQUEST_CAMERA, Manifest.permission.CAMERA);
+            return;
+        }
+
+        setFlashlight(toggle ? !torchEnabled : enabled);
+        callbackContext.success(flashlightStatus());
+    }
+
     private JSONObject flashlightStatus() throws Exception {
         JSONObject result = new JSONObject();
         result.put("available", context().getPackageManager().hasSystemFeature(PackageManager.FEATURE_CAMERA_FLASH));
         result.put("enabled", torchEnabled);
         result.put("permission", "android.permission.CAMERA");
         result.put("permissionGranted", hasCameraPermission());
+        result.put("requiresSettings", !hasCameraPermission() && shouldOpenSettingsForRuntimePermission(Manifest.permission.CAMERA));
+        result.put("settingsOpened", false);
         return result;
     }
 

package/src/templates/cordova-plugin-html2apk-bridge/www/html2apk-bridge.js

@@ -7,6 +7,8 @@ var eventListeners = {};
 var initialNotification = null;
 var initialLink = null;
 var scheduledNotificationCounter = 0;
+var deviceReady = typeof document === "undefined";
+var deviceReadyCallbacks = [];
 var eventAliases = {
   "app:ready": "app:pronto",
   "app:paused": "app:pausado",
@@ -20,9 +22,36 @@ var eventAliases = {
   "notification:clicked": "notificacao:clicada"
 };
 
+function markDeviceReady() {
+  if (deviceReady) {
+    return;
+  }
+
+  deviceReady = true;
+  deviceReadyCallbacks.splice(0).forEach(function (callback) {
+    callback();
+  });
+}
+
+function whenDeviceReady() {
+  if (deviceReady) {
+    return Promise.resolve();
+  }
+
+  return new Promise(function (resolve) {
+    deviceReadyCallbacks.push(resolve);
+  });
+}
+
+if (typeof document !== "undefined") {
+  document.addEventListener("deviceready", markDeviceReady, false);
+}
+
 function call(action, args) {
-  return new Promise(function (resolve, reject) {
-    exec(resolve, reject, "Html2ApkBridge", action, args || []);
+  return whenDeviceReady().then(function () {
+    return new Promise(function (resolve, reject) {
+      exec(resolve, reject, "Html2ApkBridge", action, args || []);
+    });
   });
 }