Handle "Never Ask Again" in permissions and add requestMultiplePermissions

Summary:
In order to get featured in the Google Play Store, we had to handle a few specific cases with permissions based on feedback from the editorial team.

First, which was previously possible with this permissions module was bumping the sdk to version 23.

The second is requesting multiple permissions at one time. In order for the camera + upload to work, we needed to request both camera permissions + media storage in one flow.

The last is handling the case where the user checks the "Never Ask Again" box. This will only appear after a user denies a permission once and is then prompted again. The logic for handling this case is taken from here: http://stackoverflow.com/questions/31928868/how-do-we-distinguish-never-asked-from-stop-asking-in-android-ms-runtime-permis/35495372#35495372

We were also seeing a few crashes similar to #10009 due to `onRequestPermissionsResult` being called before `onResume` (http://stackoverflow.com/questions/35205643/why-is-onresume-called-after-onrequestpermissionsresult), so I delaye
Closes https://github.com/facebook/react-native/pull/10221

Differential Revision: D4232551

fbshipit-source-id: fee698d1c48a2d86623cb87996f3d17f4c10a62e

Libraries/PermissionsAndroid/PermissionsAndroid.js

@@ -19,6 +19,8 @@ type Rationale = {
   message: string;
 }
 
+type PermissionStatus = 'granted' | 'denied' | 'never_ask_again';
+
 /**
  * `PermissionsAndroid` provides access to Android M's new permissions model.
  * Some permissions are granted by default when the application is installed
@@ -47,7 +49,7 @@ type Rationale = {
  *                    'so you can take awesome pictures.'
  *       }
  *     )
- *     if (granted) {
+ *     if (granted === PermissionsAndroid.RESULTS.GRANTED) {
  *       console.log("You can use the camera")
  *     } else {
  *       console.log("Camera permission denied")
@@ -61,6 +63,7 @@ type Rationale = {
 
 class PermissionsAndroid {
   PERMISSIONS: Object;
+  RESULTS: Object;
 
   constructor() {
     /**
@@ -92,17 +95,38 @@ class PermissionsAndroid {
       READ_EXTERNAL_STORAGE: 'android.permission.READ_EXTERNAL_STORAGE',
       WRITE_EXTERNAL_STORAGE: 'android.permission.WRITE_EXTERNAL_STORAGE',
     };
+
+    this.RESULTS = {
+      GRANTED: 'granted',
+      DENIED: 'denied',
+      NEVER_ASK_AGAIN: 'never_ask_again',
+    };
+  }
+
+  /**
+   * DEPRECATED - use check
+   *
+   * Returns a promise resolving to a boolean value as to whether the specified
+   * permissions has been granted
+   *
+   * @deprecated
+   */
+  checkPermission(permission: string) : Promise<boolean> {
+    console.warn('"PermissionsAndroid.checkPermission" is deprecated. Use "PermissionsAndroid.check" instead');
+    return Permissions.checkPermission(permission);
   }
 
   /**
    * Returns a promise resolving to a boolean value as to whether the specified
    * permissions has been granted
    */
-  checkPermission(permission: string) : Promise<boolean> {
+  check(permission: string) : Promise<boolean> {
     return Permissions.checkPermission(permission);
   }
 
   /**
+   * DEPRECATED - use request
+   *
    * Prompts the user to enable a permission and returns a promise resolving to a
    * boolean value indicating whether the user allowed or denied the request
    *
@@ -111,8 +135,26 @@ class PermissionsAndroid {
    * necessary to show a dialog explaining why the permission is needed
    * (https://developer.android.com/training/permissions/requesting.html#explain)
    * and then shows the system permission dialog
+   *
+   * @deprecated
    */
   async requestPermission(permission: string, rationale?: Rationale) : Promise<boolean> {
+    console.warn('"PermissionsAndroid.requestPermission" is deprecated. Use "PermissionsAndroid.request" instead');
+    const response = await this.request(permission, rationale);
+    return (response === this.RESULTS.GRANTED);
+  }
+
+  /**
+   * Prompts the user to enable a permission and returns a promise resolving to a
+   * string value indicating whether the user allowed or denied the request
+   *
+   * If the optional rationale argument is included (which is an object with a
+   * `title` and `message`), this function checks with the OS whether it is
+   * necessary to show a dialog explaining why the permission is needed
+   * (https://developer.android.com/training/permissions/requesting.html#explain)
+   * and then shows the system permission dialog
+   */
+  async request(permission: string, rationale?: Rationale) : Promise<PermissionStatus> {
     if (rationale) {
       const shouldShowRationale = await Permissions.shouldShowRequestPermissionRationale(permission);
 
@@ -128,6 +170,15 @@ class PermissionsAndroid {
     }
     return Permissions.requestPermission(permission);
   }
+
+  /**
+   * Prompts the user to enable multiple permissions in the same dialog and
+   * returns an object with the permissions as keys and strings as values
+   * indicating whether the user allowed or denied the request
+   */
+  requestMultiple(permissions: Array<string>) : Promise<{[permission: string]: PermissionStatus}> {
+    return Permissions.requestMultiplePermissions(permissions);
+  }
 }
 
 PermissionsAndroid = new PermissionsAndroid();