feat(android): switch to new callback-style permission requests

android/capacitor/src/main/java/com/getcapacitor/Bridge.java

@@ -758,8 +758,9 @@ public void startActivityForPluginWithResult(PluginCall call, Intent intent, int
     }
 
     /**
-     * Handle a request permission result by finding the that requested
-     * the permission and calling their permission handler
+     * Check for legacy Capacitor or Cordova plugins that may have registered to handle a permission
+     * request, and handle them if so. If not handled, false is returned.
+     *
      * @param requestCode the code that was requested
      * @param permissions the permissions requested
      * @param grantResults the set of granted/denied permissions

android/capacitor/src/main/java/com/getcapacitor/BridgeActivity.java

@@ -164,6 +164,22 @@ public void onDetachedFromWindow() {
         this.bridge.onDetachedFromWindow();
     }
 
+    /**
+     * Handles permission request results.
+     *
+     * Capacitor is backwards compatible such that plugins using legacy permission request codes
+     * may coexist with plugins using the AndroidX Activity v1.2 permission callback flow introduced
+     * in Capacitor 3.0.
+     *
+     * In this method, plugins are checked first for ownership of the legacy permission request code.
+     * If the {@link Bridge#onRequestPermissionsResult(int, String[], int[])} method indicates it has
+     * handled the permission, then the permission callback will be considered complete. Otherwise,
+     * the permission will be handled using the AndroidX Activity flow.
+     *
+     * @param requestCode the request code associated with the permission request
+     * @param permissions the Android permission strings requested
+     * @param grantResults the status result of the permission request
+     */
     @Override
     public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
         if (this.bridge == null) {

android/capacitor/src/main/java/com/getcapacitor/Plugin.java

@@ -67,7 +67,7 @@ public class Plugin {
     /**
      * Base activity result launcher used by the {@link #requestPermissions(PluginCall)} plugin call
      */
-    protected ActivityResultLauncher<String[]> basePermissionLauncher = null;
+    private ActivityResultLauncher<String[]> basePermissionLauncher = null;
 
     /**
      * Launchers used by the plugin to request permissions

android/capacitor/src/main/java/com/getcapacitor/cordova/MockCordovaInterfaceImpl.java

@@ -18,8 +18,8 @@ public CordovaPlugin getActivityResultCallback() {
     }
 
     /**
-     * Use in lieu of {@link CordovaInterfaceImpl#onRequestPermissionResult(int, String[], int[])} to return
-     * a boolean if Cordova is handling the permission request with a registered code.
+     * Checks Cordova permission callbacks to handle permissions defined by a Cordova plugin.
+     * Returns true if Cordova is handling the permission request with a registered code.
      *
      * @param requestCode
      * @param permissions