Request user permissions from React Native, iOS + Android

The current supported permissions are:

• Location
• Camera
• Microphone
• Photos
• Contacts
• Events
• Reminders (iOS only)
• Bluetooth (iOS only)
• Push Notifications (iOS only)
• Background Refresh (iOS only)
• Speech Recognition (iOS only)

##General Usage

npm install --save react-native-permissions
rnpm link

Add permissions to manifest for android and info.plist for ios (xcode >=8). See notes below for more details.

const Permissions = require('react-native-permissions');

//...
  //check the status of a single permission
  componentDidMount() {
    Permissions.getPermissionStatus('photo')
      .then(response => {
        //response is one of: 'authorized', 'denied', 'restricted', or 'undetermined'
        this.setState({ photoPermission: response })
      });
  }

  //request permission to access photos
  _requestPermission() {
    Permissions.requestPermission('photo')
      .then(response => {
        //returns once the user has chosen to 'allow' or to 'not allow' access
        //response is one of: 'authorized', 'denied', 'restricted', or 'undetermined'
        this.setState({ photoPermission: response })
      });
  }

  //check the status of multiple permissions
  _checkCameraAndPhotos() {
    Permissions.checkMultiplePermissions(['camera', 'photo'])
      .then(response => {
        //response is an object mapping type to permission
        this.setState({
          cameraPermission: response.camera,
          photoPermission: response.photo,
        })
      });
  }

  // this is a common pattern when asking for permissions.
  // iOS only gives you once chance to show the permission dialog,
  // after which the user needs to manually enable them from settings.
  // the idea here is to explain why we need access and determine if
  // the user will say no, so that we don't blow our one chance.
  // if the user already denied access, we can ask them to enable it from settings.
  _alertForPhotosPermission() {
    Alert.alert(
      'Can we access your photos?',
      'We need access so you can set your profile pic',
      [
        {text: 'No way', onPress: () => console.log('permission denied'), style: 'cancel'},
        this.state.photoPermission == 'undetermined'?
          {text: 'OK', onPress: this._requestPermission.bind(this)}
          : {text: 'Open Settings', onPress: Permissions.openSettings}
      ]
    )
  }
//...

##API

###Permission statuses Promises resolve into one of these statuses

###Supported permission types

###Methods

###iOS Notes Permission type bluetooth represents the status of the CBPeripheralManager. Don't use this if only need CBCentralManager

Permission type location accepts a second parameter for requestPermission and getPermissionStatus; the second parameter is a string, either always or whenInUse(default).

Permission type notification accepts a second parameter for requestPermission. The second parameter is an array with the desired alert types. Any combination of alert, badge and sound (default requests all three)

///example
    Permissions.getPermissionStatus('location', 'always')
      .then(response => {
        this.setState({ locationPermission: response })
      })

    Permissions.requestPermission('location', 'always')
      .then(response => {
        this.setState({ locationPermission: response })
      })

    Permissions.requestPermission('notification', ['alert', 'badge'])
      .then(response => {
        this.setState({ notificationPermission: response })
      })

You cannot request microphone permissions on the simulator.

With Xcode 8, you now need to add usage descriptions for each permission you will request. Open Xcode > Info.plist > Add a key (starting with "Privacy - ...") with your kit specific permission.

Example: If you need Contacts permission you have to add the key "Privacy - Contacts Usage Description".

###Android Notes

Requires RN >= 0.29.0

All required permissions also need to be included in the Manifest before they can be requested. Otherwise requestPermission will immediately return denied.

Permissions are automatically accepted for targetSdkVersion < 23 but you can still use getPermissionStatus to check if the user has disabled them from Settings.

Here's a map of types to Android system permissions names: location -> android.permission.ACCESS_FINE_LOCATION camera -> android.permission.CAMERA microphone -> android.permission.RECORD_AUDIO photo -> android.permission.READ_EXTERNAL_STORAGE storage -> android.permission.READ_EXTERNAL_STORAGE contacts -> android.permission.READ_CONTACTS event -> android.permission.READ_CALENDAR

You can request write access to any of these types by also including the appropriate write permission in the Manifest. Read more here: https://developer.android.com/guide/topics/security/permissions.html#normal-dangerous

##Setup

npm install --save react-native-permissions
rnpm link

###Or manualy linking

####iOS

• Run open node_modules/react-native-permissions
• Drag ReactNativePermissions.xcodeproj into the Libraries group of your app's Xcode project
• Add libReactNativePermissions.a to `Build Phases -> Link Binary With Libraries.

####Android #####Step 1 - Update Gradle Settings

// file: android/settings.gradle
...

include ':react-native-permissions'
project(':react-native-permissions').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-permissions/android')

#####Step 2 - Update Gradle Build

// file: android/app/build.gradle
...

dependencies {
    ...
    compile project(':react-native-permissions')
}

#####Step 3 - Register React Package

...
import com.joshblour.reactnativepermissions.ReactNativePermissionsPackage; // <--- import

public class MainApplication extends Application implements ReactApplication {

    ...

    @Override
    protected List<ReactPackage> getPackages() {
        return Arrays.<ReactPackage>asList(
            new MainReactPackage(),
            new ReactNativePermissionsPackage() // <------ add the package
        );
    }

    ...
}

##Troubleshooting

A: rnpm may not have linked correctly. Follow the manual linking steps and make sure the library is linked

A: starting with xcode 8, you need to add permission descriptions. see iOS notes for more details. Thanks to @jesperlndk for discovering this.

A: This is normal. iOS restarts your app when your privacy settings change. Just google "ios crash permission change"