xref: /expo/docs/components/plugins/permissions/data/ios.json (revision 561a1919)

{
  "meta": {
    "source": "https://developer.apple.com/documentation/bundleresources/information_property_list/protected_resources",
    "scrapedAt": "2021-07-21T21:09:09Z"
  },
  "data": {
    "NSBluetoothAlwaysUsageDescription": {
      "apiAdded": "iOS 13.0+  tvOS 13.0+  watchOS 6.0+",
      "apiDeprecated": false,
      "framework": "Core Bluetooth",
      "name": "NSBluetoothAlwaysUsageDescription",
      "description": "A message that tells the user why the app needs access to Bluetooth.",
      "warning": "If your app has a deployment target earlier than iOS 13, add the NSBluetoothPeripheralUsageDescription key to your app’s Information Property List file in addition to this key."
    },
    "NSBluetoothPeripheralUsageDescription": {
      "apiAdded": "iOS 6.0–13.0",
      "apiDeprecated": true,
      "framework": "Core Bluetooth",
      "name": "NSBluetoothPeripheralUsageDescription",
      "description": "A message that tells the user why the app is requesting the ability to connect to Bluetooth peripherals.",
      "warning": "This key is required if your app uses APIs that access Bluetooth peripherals and has a deployment target earlier than iOS 13."
    },
    "NSCalendarsUsageDescription": {
      "apiAdded": "iOS 6.0+  macOS 10.14+",
      "apiDeprecated": false,
      "framework": "EventKit",
      "name": "NSCalendarsUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the user’s calendar data.",
      "warning": "This key is required if your app uses APIs that access the user’s calendar data."
    },
    "NSRemindersUsageDescription": {
      "apiAdded": "iOS 6.0+  macOS 10.14+",
      "apiDeprecated": false,
      "framework": "EventKit",
      "name": "NSRemindersUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the user’s reminders.",
      "warning": "This key is required if your app uses APIs that access the user’s reminders."
    },
    "NSCameraUsageDescription": {
      "apiAdded": "iOS 7.0+  macOS 10.14+",
      "apiDeprecated": false,
      "framework": "AVFoundation",
      "name": "NSCameraUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the device’s camera.",
      "warning": "This key is required if your app uses APIs that access the device’s camera."
    },
    "NSMicrophoneUsageDescription": {
      "apiAdded": "iOS 7.0+  macOS 10.14+  watchOS 4.0+",
      "apiDeprecated": false,
      "framework": "AVFoundation",
      "name": "NSMicrophoneUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the device’s microphone.",
      "warning": "This key is required if your app uses APIs that access the device’s microphone."
    },
    "NSContactsUsageDescription": {
      "apiAdded": "iOS 6.0+  macOS 10.8+",
      "apiDeprecated": false,
      "framework": "Contacts",
      "name": "NSContactsUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the user’s contacts.",
      "warning": "This key is required if your app uses APIs that access the user’s contacts."
    },
    "NSFaceIDUsageDescription": {
      "apiAdded": "iOS 11.0+",
      "apiDeprecated": false,
      "framework": "Local Authentication",
      "name": "NSFaceIDUsageDescription",
      "description": "A message that tells the user why the app is requesting the ability to authenticate with Face ID.",
      "warning": "This key is required if your app uses APIs that access Face ID."
    },
    "NSDesktopFolderUsageDescription": {
      "apiAdded": "macOS 10.15+",
      "apiDeprecated": false,
      "framework": "Foundation",
      "name": "NSDesktopFolderUsageDescription",
      "description": "A message that tells the user why the app needs access to the user’s Desktop folder.",
      "warning": null
    },
    "NSDocumentsFolderUsageDescription": {
      "apiAdded": "macOS 10.15+",
      "apiDeprecated": false,
      "framework": "Foundation",
      "name": "NSDocumentsFolderUsageDescription",
      "description": "A message that tells the user why the app needs access to the user’s Documents folder.",
      "warning": null
    },
    "NSDownloadsFolderUsageDescription": {
      "apiAdded": "macOS 10.15+",
      "apiDeprecated": false,
      "framework": "Foundation",
      "name": "NSDownloadsFolderUsageDescription",
      "description": "A message that tells the user why the app needs access to the user’s Downloads folder.",
      "warning": null
    },
    "NSNetworkVolumesUsageDescription": {
      "apiAdded": "macOS 10.15+",
      "apiDeprecated": false,
      "framework": "Foundation",
      "name": "NSNetworkVolumesUsageDescription",
      "description": "A message that tells the user why the app needs access to files on a network volume.",
      "warning": null
    },
    "NSRemovableVolumesUsageDescription": {
      "apiAdded": "macOS 10.15+",
      "apiDeprecated": false,
      "framework": "Foundation",
      "name": "NSRemovableVolumesUsageDescription",
      "description": "A message that tells the user why the app needs access to files on a removable volume.",
      "warning": null
    },
    "NSFileProviderPresenceUsageDescription": {
      "apiAdded": "macOS 10.15+",
      "apiDeprecated": false,
      "framework": "Foundation",
      "name": "NSFileProviderPresenceUsageDescription",
      "description": "A message that tells the user why the app needs to be informed when other apps access files that it manages.",
      "warning": null
    },
    "NSFileProviderDomainUsageDescription": {
      "apiAdded": "macOS 10.15+",
      "apiDeprecated": false,
      "framework": "Foundation",
      "name": "NSFileProviderDomainUsageDescription",
      "description": "A message that tells the user why the app needs access to files managed by a file provider.",
      "warning": null
    },
    "NSGKFriendListUsageDescription": {
      "apiAdded": "iOS 14.5+",
      "apiDeprecated": false,
      "framework": "GameKit",
      "name": "NSGKFriendListUsageDescription",
      "description": "A message that tells the user why the app needs access to their Game Center friends list.",
      "warning": null
    },
    "NSHealthClinicalHealthRecordsShareUsageDescription": {
      "apiAdded": "iOS 12.0+",
      "apiDeprecated": false,
      "framework": "HealthKit",
      "name": "NSHealthClinicalHealthRecordsShareUsageDescription",
      "description": "A message to the user that explains why the app requested permission to read clinical records.",
      "warning": "This key is required if your app uses APIs that access the user's clinical records."
    },
    "NSHealthShareUsageDescription": {
      "apiAdded": "iOS 8.0+",
      "apiDeprecated": false,
      "framework": "HealthKit",
      "name": "NSHealthShareUsageDescription",
      "description": "A message to the user that explains why the app requested permission to read samples from the HealthKit store.",
      "warning": "This key is required if your app uses APIs that access the user’s heath data."
    },
    "NSHealthUpdateUsageDescription": {
      "apiAdded": "iOS 8.0+",
      "apiDeprecated": false,
      "framework": "HealthKit",
      "name": "NSHealthUpdateUsageDescription",
      "description": "A message to the user that explains why the app requested permission to save samples to the HealthKit store.",
      "warning": "This key is required if your app uses APIs that update the user’s health data."
    },
    "NSHomeKitUsageDescription": {
      "apiAdded": "iOS 8.0+  watchOS 2.0+",
      "apiDeprecated": false,
      "framework": "HomeKit",
      "name": "NSHomeKitUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the user’s HomeKit configuration data.",
      "warning": "This key is required if your app uses APIs that access the user’s HomeKit configuration data."
    },
    "NSLocationAlwaysAndWhenInUseUsageDescription": {
      "apiAdded": "iOS 11.0+",
      "apiDeprecated": false,
      "framework": "Core Location",
      "name": "NSLocationAlwaysAndWhenInUseUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the user’s location information at all times.",
      "warning": "This key is required if your iOS app uses APIs that access the user’s location information at all times."
    },
    "NSLocationUsageDescription": {
      "apiAdded": "iOS 6.0–8.0  macOS 10.14+",
      "apiDeprecated": true,
      "framework": "Core Location",
      "name": "NSLocationUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the user’s location information.",
      "warning": "This key is required if your macOS app uses APIs that access the user’s location information."
    },
    "NSLocationWhenInUseUsageDescription": {
      "apiAdded": "iOS 11.0+",
      "apiDeprecated": false,
      "framework": "Core Location",
      "name": "NSLocationWhenInUseUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the user’s location information while the app is running in the foreground.",
      "warning": "This key is required if your iOS app uses APIs that access the user’s location information while the app is in use."
    },
    "NSLocationAlwaysUsageDescription": {
      "apiAdded": "iOS 8.0–10.0",
      "apiDeprecated": true,
      "framework": "Core Location",
      "name": "NSLocationAlwaysUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the user's location at all times.DeprecatedFor apps deployed to targets in iOS 11 and later, use NSLocationAlwaysAndWhenInUseUsageDescription instead.",
      "warning": "This key is required if your iOS app uses APIs that access the user’s location at all times and deploys to targets earlier than iOS 11."
    },
    "NSAppleMusicUsageDescription": {
      "apiAdded": "iOS 2.0+",
      "apiDeprecated": false,
      "framework": "Media Player",
      "name": "NSAppleMusicUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the user’s media library.",
      "warning": "This key is required if your app uses APIs that access the user’s media library."
    },
    "NSMotionUsageDescription": {
      "apiAdded": "iOS 7.0+  macOS 10.15+",
      "apiDeprecated": false,
      "framework": "Core Motion",
      "name": "NSMotionUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the device’s motion data.",
      "warning": "This key is required if your app uses APIs that access the device’s motion data, including CMSensorRecorder, CMPedometer, CMMotionActivityManager, and CMMovementDisorderManager. If you don’t include this key, your app will crash when it attempts to access motion data."
    },
    "NSFallDetectionUsageDescription": {
      "apiAdded": "watchOS 7.2+",
      "apiDeprecated": false,
      "framework": "Core Motion",
      "name": "NSFallDetectionUsageDescription",
      "description": "A message to the user that explains the app’s request for permission to access fall detection event data.",
      "warning": "If your app uses the CMFallDetectionManager, the app requires this key."
    },
    "NSLocalNetworkUsageDescription": {
      "apiAdded": "iOS 14.0+  macOS 11.0+  tvOS 14.0+",
      "apiDeprecated": false,
      "framework": "Network",
      "name": "NSLocalNetworkUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the local network.",
      "warning": null
    },
    "NSNearbyInteractionUsageDescription": {
      "apiAdded": "iOS 15.0+ Beta watchOS 8.0+ Beta",
      "apiDeprecated": false,
      "framework": "Nearby Interaction",
      "name": "NSNearbyInteractionUsageDescription",
      "description": "A request for user permission to begin an interaction session with nearby devices.",
      "warning": null
    },
    "NSNearbyInteractionAllowOnceUsageDescription": {
      "apiAdded": "iOS 14.0–15.0",
      "apiDeprecated": true,
      "framework": "Nearby Interaction",
      "name": "NSNearbyInteractionAllowOnceUsageDescription",
      "description": "A one-time request for user permission to begin an interaction session with nearby devices.",
      "warning": null
    },
    "NFCReaderUsageDescription": {
      "apiAdded": "iOS 11.0+",
      "apiDeprecated": false,
      "framework": "Core NFC",
      "name": "NFCReaderUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the device’s NFC hardware.",
      "warning": "You’re required to provide this key if your app uses APIs that access the NFC hardware."
    },
    "NSPhotoLibraryAddUsageDescription": {
      "apiAdded": "iOS 11.0+",
      "apiDeprecated": false,
      "framework": "Photos",
      "name": "NSPhotoLibraryAddUsageDescription",
      "description": "A message that tells the user why the app is requesting add-only access to the user’s photo library.",
      "warning": "This key is required if your app uses APIs that have write access to the user’s photo library."
    },
    "NSPhotoLibraryUsageDescription": {
      "apiAdded": "iOS 6.0+  macOS 10.14+",
      "apiDeprecated": false,
      "framework": "Photos",
      "name": "NSPhotoLibraryUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the user’s photo library.",
      "warning": "This key is required if your app uses APIs that have read or write access to the user’s photo library."
    },
    "NSUserTrackingUsageDescription": {
      "apiAdded": "iOS 14.0+  tvOS 14.0+",
      "apiDeprecated": false,
      "framework": "Security",
      "name": "NSUserTrackingUsageDescription",
      "description": "A message that informs the user why an app is requesting permission to use data for tracking the user or the device.",
      "warning": null
    },
    "NSAppleEventsUsageDescription": {
      "apiAdded": "macOS 10.14+",
      "apiDeprecated": false,
      "framework": "Security",
      "name": "NSAppleEventsUsageDescription",
      "description": "A message that tells the user why the app is requesting the ability to send Apple events.",
      "warning": "This key is required if your app uses APIs that send Apple events."
    },
    "NSSystemAdministrationUsageDescription": {
      "apiAdded": "macOS 10.14+",
      "apiDeprecated": false,
      "framework": "Security",
      "name": "NSSystemAdministrationUsageDescription",
      "description": "A message in macOS that tells the user why the app is requesting to manipulate the system configuration.",
      "warning": "This key is required if your app uses APIs that manipulate the system configuration."
    },
    "NSSensorKitUsageDescription": {
      "apiAdded": "iOS 14.0+",
      "apiDeprecated": false,
      "framework": "SensorKit",
      "name": "NSSensorKitUsageDescription",
      "description": "No overview available.",
      "warning": null
    },
    "NSSiriUsageDescription": {
      "apiAdded": "iOS 10.0+",
      "apiDeprecated": false,
      "framework": "Intents",
      "name": "NSSiriUsageDescription",
      "description": "A message that tells the user why the app is requesting to send user data to Siri.",
      "warning": "This key is required if your app uses APIs that send user data to Siri."
    },
    "NSSpeechRecognitionUsageDescription": {
      "apiAdded": "iOS 10.0+  macOS 10.15+",
      "apiDeprecated": false,
      "framework": "Speech",
      "name": "NSSpeechRecognitionUsageDescription",
      "description": "A message that tells the user why the app is requesting to send user data to Apple’s speech recognition servers.",
      "warning": "This key is required if your app uses APIs that send user data to Apple’s speech recognition servers."
    },
    "NSVideoSubscriberAccountUsageDescription": {
      "apiAdded": "tvOS 12.0+",
      "apiDeprecated": false,
      "framework": "TVUIKit",
      "name": "NSVideoSubscriberAccountUsageDescription",
      "description": "A message that tells the user why the app is requesting access to the user’s TV provider account.",
      "warning": "This key is required if your app uses APIs that access the user’s TV provider account."
    }
  }
}