Merge pull request #91 from SandroMachado/support/appstore-disclaimer

Add AppStore submission disclaimer

README.md

@@ -21,7 +21,7 @@ The current supported permissions are:
 | 0.2.5 | 0.33.0 - 0.39.0 |
 *Complies with [react-native-version-support-table](https://github.com/dangnelson/react-native-version-support-table)*
 
-##General Usage
+## General Usage
 ```
 npm install --save react-native-permissions
 rnpm link
@@ -85,9 +85,9 @@ const Permissions = require('react-native-permissions');
 //...
 ```
 
-##API
+## API
 
-###Permission statuses
+### Permission statuses
 Promises resolve into one of these statuses
 
 | Return value | Notes|
@@ -97,7 +97,7 @@ Promises resolve into one of these statuses
 |`restricted`| *(iOS only)* user is not able to grant this permission, either because it's not supported by the device or because it has been blocked by parental controls. |
 |`undetermined`| user has not yet been prompted with a permission dialog |
 
-###Supported permission types
+### Supported permission types
 
 | Name | iOS | Android |
 |---|---|---|
@@ -114,7 +114,7 @@ Promises resolve into one of these statuses
 |`speechRecognition`| ✔️ | ❌ |
 |`storage`| ❌️ | ✔ |
 
-###Methods
+### Methods
 | Method Name | Arguments | Notes
 |---|---|---|
 | `getPermissionStatus` | `type` | - Returns a promise with the permission status. See iOS Notes for special cases |
@@ -124,7 +124,7 @@ Promises resolve into one of these statuses
 | `openSettings` | *none* | - Switches the user to the settings page of your app (iOS 8.0 and later)  |
 | `canOpenSettings` | *none* | - Returns a boolean indicating if the device supports switching to the settings page |
 
-###iOS Notes
+### 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).
@@ -157,7 +157,7 @@ Example:
 If you need Contacts permission you have to add the key "Privacy - Contacts Usage Description".
 <img width="338" alt="3cde3b44-7ffd-11e6-918b-63888e33f983" src="https://cloud.githubusercontent.com/assets/1440796/18713019/271be540-8011-11e6-87fb-c3828c172dfc.png">
 
-###Android Notes
+### Android Notes
 
 Requires RN >= 0.29.0
 
@@ -177,22 +177,22 @@ Here's a map of types to Android system permissions names:
 
 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
+## Setup
 
 ````
 npm install --save react-native-permissions
 rnpm link
 ````
 
-###Or manualy linking
+### Or manualy linking
 
-####iOS
+#### 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
+#### Android
+##### Step 1 - Update Gradle Settings
 
 ```
 // file: android/settings.gradle
@@ -201,7 +201,7 @@ rnpm link
 include ':react-native-permissions'
 project(':react-native-permissions').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-permissions/android')
 ```
-#####Step 2 - Update Gradle Build
+##### Step 2 - Update Gradle Build
 
 ```
 // file: android/app/build.gradle
@@ -212,7 +212,7 @@ dependencies {
     compile project(':react-native-permissions')
 }
 ```
-#####Step 3 - Register React Package
+##### Step 3 - Register React Package
 ```
 ...
 import com.joshblour.reactnativepermissions.ReactNativePermissionsPackage; // <--- import
@@ -232,8 +232,34 @@ public class MainApplication extends Application implements ReactApplication {
     ...
 }
 ```
+## AppStore submission disclaimer
 
-##Troubleshooting
+If you need to submit you application to the AppStore, you need to add to your `Info.plist` all `*UsageDescription` keys with a string value explaining to the user how the app uses this data. **Even if you don't use them**.
+
+So before submitting your app to the `AppStore`, make sure that in your `Info.plist` you have the following keys:
+
+```
+
+<key>NSBluetoothPeripheralUsageDescription</key>
+<string>Some description</string>
+<key>NSCalendarsUsageDescription</key>
+<string>Some description</string>
+<key>NSCameraUsageDescription</key>
+<string>Some description</string>
+<key>NSLocationWhenInUseUsageDescription</key>
+<string>Some description</string>
+<key>NSPhotoLibraryUsageDescription</key>
+<string>Some description</string>
+
+```
+
+This is required because during the phase of `processing` in the `AppStore` submission, the system detects that you app contains code to request the permission `X` but don't have the `UsageDescription` key and rejects the build.
+
+> Please note that it will only be shown to the users the usage descriptions of the permissions you really require in your app.
+
+You can find more informations about this issue in #46.
+
+## Troubleshooting
 
 #### Q: Android - `undefined is not a object (evaluating 'RNPermissions.requestPermissions')`
 A: `rnpm` may not have linked correctly. Follow the manual linking steps and make sure the library is linked