安装

• tns plugin add nativescript-perms

添加插件后请确保运行新的构建，以避免任何问题。

这是从 react-native-permissions 转换而来

API

权限状态

承诺解析为 [状态:Status, 总是:boolean]，其中状态是以下状态之一

支持的权限类型

当前支持的权限有

方法

iOS 备注

• 权限类型 bluetooth 表示 CBPeripheralManager 的状态。如果只需要 CBCentralManager，则不要使用此类型
• 权限类型 location 接受 request() 和 check() 的第二个参数；第二个参数是字符串，可以是 always 或 whenInUse（默认）。
• 权限类型 notification 接受 request() 的第二个参数。第二个参数是一个包含所需警报类型的数组。可以是 alert、badge 和 sound 的任何组合（默认请求所有三个）。
• 如果您不请求媒体库，则可以删除 xcode 项目中的 MediaPlayer.framework。

// example
Permissions.check('location', { type: 'always' }).then(response => {
  this.setState({ locationPermission: response[0] })
})

Permissions.request('location', { type: 'always' }).then(response => {
  this.setState({ locationPermission: response[0] })
})

Permissions.request('notification', { type: ['alert', 'badge'] }).then(
  response => {
    this.setState({ notificationPermission: response[0] })
  },
)

• 您不能在模拟器上请求麦克风权限。
• 从 Xcode 8 开始，您现在需要为将请求的每个权限添加使用描述。打开 Xcode ➜ Info.plist ➜ 添加一个以 "Privacy - ..." 开头的键，包含您套件特定的权限。

示例：如果您需要联系人权限，您必须添加键 Privacy - Contacts Usage Description。

App Store 提交免责声明

如果您需要将应用程序提交到 AppStore，您需要将所有 *UsageDescription 键添加到您的 Info.plist 中，并包含一个字符串值，解释应用程序如何使用这些数据。即使您不使用它们。

因此，在提交应用程序到 App Store 之前，请确保在您的 Info.plist 中有以下键

<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>NSPhotoLibraryAddUsageDescription</key>
<string>Some description</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Some description</string>
<key>NSSpeechRecognitionUsageDescription</key>
<string>Some description</string>
<key>NSAppleMusicUsageDescription</key>
<string>Some description</string>
<key>NSMotionUsageDescription</key>
<string>Some description</string>

这是必需的，因为在 App Store 提交处理阶段，系统检测到您的应用程序包含请求权限 X 的代码，但没有 UsageDescription 键，然后它拒绝构建。

请注意，这只会向用户显示您应用程序中实际需要的权限的使用描述。

您可以在 #46 中找到有关此问题的更多信息。

Android 说明

• 在请求之前，所有必需的权限也需要包含在 AndroidManifest.xml 文件中。否则 request() 将立即返回 denied。

• 您可以通过在 AndroidManifest.xml 文件中也包括适当的写入权限来请求对任何这些类型的写入访问。更多信息请参阅 这里。

• 可选的理由参数将显示对话框提示。

// example
Permissions.request('camera', {
  rationale: {
    title: 'Cool Photo App Camera Permission',
    message:
      'Cool Photo App needs access to your camera ' +
      'so you can take awesome pictures.',
  },
}).then(response => {
  this.setState({ cameraPermission: response[0] })
})

• 对于 targetSdkVersion < 23 的目标，权限将自动接受，但您仍然可以使用 check() 检查用户是否已在设置中禁用它们。

您可能需要在您的 build.gradle 中提高 targetSdkVersion 版本。

android {
  compileSdkVersion 23 // ← set at least 23
  buildToolsVersion "23.0.1"  // ← set at least 23.0.0

  defaultConfig {
    minSdkVersion 16
    targetSdkVersion 23 // ← set at least 23
    // ...

故障排除

问题：iOS - 请求权限后应用程序立即崩溃

答案：从 Xcode 8 开始，您需要添加权限描述。有关详细信息，请参阅 iOS 说明。感谢 @jesperlndk 发现此问题。

问题：iOS - 我更改设置中的权限时应用程序崩溃

答案：这是正常的。iOS 在您的隐私设置更改时重新启动您的应用程序。只需搜索 "iOS crash permission change" 即可。