iOS 11 Camera/Microphone/Location Permissions Plugin for Apache Cordova
Cordova / PhoneGap Plugin Permission Settings for NSCameraUsageDescription, NSLocationWhenInUseUsageDescription, NSLocationAlwaysAndWhenInUseUsageDescription, NSPhotoLibraryAddUsageDescription, NSPhotoLibraryUsageDescription and NSMicrophoneUsageDescription in iOS 11 by adding a declaration to the Info.plist file
Install
Latest published version on npm (with Cordova CLI >= 5.0.0)
cordova plugin add cordova-plugin-ios-cml-permissions --save
Latest version from GitHub
cordova plugin add https://github.com/dmitriy-karasyov/cordova-plugin-ios-cml-permissions.git --save
Customising the message prompts
On installation you can customise the prompts shown by setting the following variables on installation.
- CAMERA_USAGE_DESCRIPTION for NSCameraUsageDescription
- MICROPHONE_USAGE_DESCRIPTION for NSMicrophoneUsageDescription
- PHOTOLIBRARY_ADD_USAGE_DESCRIPTION for NSPhotoLibraryAddUsageDescription (write-access only, iOS 11 only)
- PHOTOLIBRARY_USAGE_DESCRIPTION for NSPhotoLibraryUsageDescription (read/write access)
- LOCATION_WHEN_IN_USAGE_DESCRIPTION for NSLocationWhenInUseUsageDescription
- LOCATION_ALWAYS_AND_WHEN_IN_USAGE_DESCRIPTION for NSLocationAlwaysAndWhenInUseUsageDescription
- LOCATION_ALWAYS_USAGE_DESCRIPTION for NSLocationAlwaysUsageDescription
For example:
cordova plugin add cordova-plugin-ios-cml-permissions --variable CAMERA_USAGE_DESCRIPTION="your message" --variable MICROPHONE_USAGE_DESCRIPTION="your message" --variable PHOTOLIBRARY_ADD_USAGE_DESCRIPTION="your message" --variable PHOTOLIBRARY_USAGE_DESCRIPTION="your message" --variable LOCATION_WHEN_IN_USAGE_DESCRIPTION="your message" --variable LOCATION_ALWAYS_AND_WHEN_IN_USAGE_DESCRIPTION="your message" --variable LOCATION_ALWAYS_USAGE_DESCRIPTION="your message" --save
Usage
For the changes to plugin.xml to take effect, you must refresh the ios.json file (inside the /plugin folder):
$ cordova platform rm ios
$ cordova platform add ios
License
[MIT License]