doc: improve documentation

- Forgot to commit everything
doc: improve documentation of onRequestPermissionResult and onRequestPermissionsResult
2026-05-30 00:00:04 +08:00 · 2026-05-06 12:25:08 +02:00 · 2026-05-06 12:23:42 +02:00
1 changed files with 15 additions and 2 deletions
@@ -416,7 +416,14 @@ public class CordovaPlugin {
    }

    /**
-     * Called by the system when the user grants permissions
+     * Forwarded system call to the plugin when the user grants permissions,
+     * denies them or the request was interrupted.
+     * This is a legacy method and should not be used anymore.
+     * Instead {@link #onRequestPermissionsResult} should be used.
+     * 
+     * Note: The system calls {@link CordovaActivity#onRequestPermissionsResult(int, String[], int[])},
+     * which calls {@link CordovaInterfaceImpl#onRequestPermissionsResult(int, String[], int[])},
+     * and finally this method.
     *
     * @param requestCode
     * @param permissions
@@ -430,11 +437,17 @@ public class CordovaPlugin {
    }

    /**
-     * Called by the system when the user grants permissions
+     * Forwarded system call to the plugin when the user grants permissions,
+     * denies them or the request was interrupted.
+     * 
+     * Note: The system calls {@link CordovaActivity#onRequestPermissionsResult(int, String[], int[])},
+     * which calls {@link CordovaInterfaceImpl#onRequestPermissionsResult(int, String[], int[])},
+     * and finally this method.
     *
     * @param requestCode
     * @param permissions
     * @param grantResults
+     * @see https://developer.android.com/reference/android/app/Activity#onRequestPermissionsResult(int,%20java.lang.String[],%20int[])
     */
    public void onRequestPermissionsResult(int requestCode, String[] permissions,
                                          int[] grantResults) throws JSONException {