github/cordova-android
3
0
Fork 1
mirror of https://github.com/apache/cordova-android.git synced 2026-07-06 00:00:08 +08:00
Code Issues Packages Projects Releases Wiki Activity

doc: improve documentation of onRequestPermissionResult and onRequestPermissionsResult (#1920)

Browse Source 
* doc: improve documentation of `onRequestPermissionResult` and `onRequestPermissionsResult`

- Make clear, that these methods are not only called, when the user grants permissions, but also when he denies them or the request was interrupted.
- Add note, how the call chain ist
- Make clear, that `onRequestPermissionResult` is legacy and should not be used anymore
- Add Android Developer documentation link for the new `onRequestPermissionsResult`

* doc: improve documentation

- Forgot to commit everything
This commit is contained in:
Manuel Beck
2026-06-30 08:49:31 +02:00
committed by GitHub
parent 929f20542f
commit 1d01ea1fc0
1 changed files with 15 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
framework/src/org/apache/cordova/CordovaPlugin.java
+15 -2
View File
@@ -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 {