[TIMOB-23627] iOS: Add required iOS10 Info.plist permission notes

apidoc/Titanium/Calendar/Calendar.yml

@@ -52,10 +52,14 @@ methods:
     description: |
         On Android, the request view will show if the permission is not accepted by the user, and the user did
         not check the box "Never ask again" when denying the request. If the user checks the box "Never ask again,"
-        the user has to manually enable the permission in device settings.
+        the user has to manually enable the permission in device settings. This method requests `Manifest.permission.READ_CALENDAR` 
+        and `Manifest.permission.WRITE_CALENDAR` on Android. If yourequire other permissions, you can also use 
+        <Titanium.Android.requestPermissions>.
+
+        In iOS 6, Apple introduced the Info.plist key `NSCalendarsUsageDescription` that is used to display an
+        own description while authorizing calendar permissions. In iOS 10, this key is mandatory and the application
+        will crash if your app does not include the key. Check the [Apple docs](https://developer.apple.com/library/prerelease/content/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html) for more information.
 
-        This method requests `Manifest.permission.READ_CALENDAR` and `Manifest.permission.WRITE_CALENDAR` on Android. If you
-        require other permissions, you can also use <Titanium.Android.requestPermissions>.
     parameters:
       - name: callback
         summary: Function to call upon user decision to grant calendar access.

apidoc/Titanium/Contacts/Contacts.yml

@@ -215,6 +215,11 @@ methods:
 
         This method requests `Manifest.permission.READ_CONTACTS` on Android. If you require other permissions, you can also
         use <Titanium.Android.requestPermissions>.
+
+        In iOS 6, Apple introduced the Info.plist key `NSContactsUsageDescription` that is used to display an
+        own description while authorizing contacts permissions. In iOS 10, this key is mandatory and the application
+        will crash if your app does not include the key. Check the [Apple docs](https://developer.apple.com/library/prerelease/content/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html) for more information.
+
     parameters:
       - name: callback
         summary: Function to call upon user decision to grant contacts access.

apidoc/Titanium/Geolocation/Geolocation.yml

@@ -246,10 +246,13 @@ methods:
         not check the box "Never ask again" when denying the request. If the user checks the box "Never ask again,"
         the user has to manually enable the permission in device settings. If the user asks for permissions or 
         tries to get unauthorized location information, then the app should call the request method to show 
-        the permission settings.
+        the permission settings. This method requests `Manifest.permission.ACCESS_FINE_LOCATION` on Android. 
+        If you require other permissions, you can also use <Titanium.Android.requestPermissions>.
 
-        This method requests `Manifest.permission.ACCESS_FINE_LOCATION` on Android. If you require other permissions, you can also
-        use <Titanium.Android.requestPermissions>.
+        In iOS 8, Apple introduced the Info.plist keys `NSLocationWhenInUseUsageDescription` and `NSLocationAlwaysUsageDescription`
+        that are used to display an own description while requesting location permissions. In addition to this method, you need to
+        include one of these keys (based on how your location updates should behave) or the application will crash if your app does not. 
+        Check the [Apple docs](https://developer.apple.com/library/prerelease/content/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html) for more information.
     parameters:
       - name: authorizationType
         summary: Types of geolocation's authorizations. This is an iOS only parameter and is ignored on Android.

apidoc/Titanium/Media/Media.yml

@@ -65,6 +65,11 @@ methods:
         type: MusicLibraryOptionsType
   - name: openPhotoGallery
     summary: Opens the photo gallery image picker.
+    description: |
+        In iOS 6, Apple introduced the Info.plist key `NSPhotoLibraryUsageDescription` that is used to display an
+        own description while authorizing gallery permissions. In iOS 10, this key is mandatory and the application
+        will crash if your app does not include the key. Check the [Apple docs](https://developer.apple.com/library/prerelease/content/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html) 
+        for more information. 
     platforms: [iphone, ipad, android]
     parameters:
       - name: options
@@ -216,9 +221,12 @@ methods:
         This method requests `Manifest.permission.CAMERA` on Android. If you require other permissions, you can also
         use <Titanium.Android.requestPermissions>.
 
-        On iOS, the request view will only show if user has not yet made a decision.
-        If the user has, the callback will return the earlier decision. To change the permission
-        the user needs to change it in device settings.
+        In iOS 6, Apple introduced the Info.plist key `NSCameraUsageDescription` that is used to display an
+        own description while authorizing camera permissions. In iOS 10, this key is mandatory and the application
+        will crash if your app does not include the key. Check the [Apple docs](https://developer.apple.com/library/prerelease/content/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html) 
+        for more information. In addition, the authorization dialog will only show if user has not made a decision, yet.
+        If the user has, the callback will return the earlier decision. To change the permission the user needs to 
+        change it in the device settings.
     parameters:
       - name: callback
         summary: Function to call upon user decision to grant camera access.
@@ -285,6 +293,12 @@ methods:
         grants or denies permission, the system remembers the choice for future use in the same app. 
         If permission is not granted, or if the user has not yet responded to the permission prompt, 
         any audio recording sessions record only silence.
+
+        In addition, Apple introduced the Info.plist key `NSMicrophoneUsageDescription` that is used to display an
+        own description while authorizing microphone permissions. In iOS 10, this key is mandatory and the application
+        will crash if your app does not include the key. Check the [Apple docs](https://developer.apple.com/library/prerelease/content/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html) 
+        for more information.
+
     platforms: [iphone, ipad]
     since: 3.1.3
     parameters: