Merge branch 'master' of github.com:react-native-community/react-native-permissions

README.md

@@ -554,6 +554,28 @@ import {openSettings} from 'react-native-permissions';
 openSettings().catch(() => console.warn('cannot open settings'));
 ```
 
+## Migrating from v1.x.x
+
+If you are currently using the version `1.x.x` and would like to switch to `v2.x.x`, the only thing you really need to know is that it's now required to select the wanted permission **per platform**.
+
+```js
+// v1.x.x
+import Permissions from 'react-native-permissions';
+
+Permissions.request('location', {type: 'whenInUse'});
+
+// v2.x.x
+import {Platform} from 'react-native';
+import {PERMISSIONS, request} from 'react-native-permissions';
+
+request(
+  Platform.select({
+    android: PERMISSIONS.ANDROID.ACCESS_FINE_LOCATION,
+    ios: PERMISSIONS.IOS.LOCATION_WHEN_IN_USE,
+  }),
+);
+```
+
 ## Additional recipes
 
 #### Check multiples permissions