鸿蒙开发Ability Kit程序框架服务：声明权限

声明权限

应用在申请权限时，需要在项目的配置文件中，逐个声明需要的权限，否则应用将无法获取授权。

在配置文件中声明权限

应用需要在module.json5配置文件的[requestPermissions]标签中声明权限。

属性	说明 开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]	取值范围
name	必须，填写需要使用的权限名称。	需为系统已定义的权限，取值范围请参考[应用权限列表]
reason	可选，当申请的权限为user_grant权限时此字段必填，用于描述申请权限的原因。**说明：**该字段用于应用上架校验，当申请的权限为user_grant权限时必填，并且需要进行多语种适配。	使用string类资源引用。格式为$string: ***。
usedScene	可选，当申请的权限为user_grant权限时此字段必填。描述权限使用的场景由abilities和when组成。其中abilities可以配置为多个UIAbility组件，when表示调用时机。**说明：**默认为可选，当申请的权限为user_grant权限时，abilities标签必填，when标签可选。	abilities：UIAbility或者ExtensionAbility组件的名称。 when：inuse（使用时）、always（始终）。

声明样例

{
  "module" : {
    // ...
    "requestPermissions":[
      {
        "name" : "ohos.permission.PERMISSION1",
        "reason": "$string:reason",
        "usedScene": {
          "abilities": [
            "FormAbility"
          ],
          "when":"inuse"
        }
      },
      {
        "name" : "ohos.permission.PERMISSION2",
        "reason": "$string:reason",
        "usedScene": {
          "abilities": [
            "FormAbility"
          ],
          "when":"always"
        }
      }
    ]
  }
}

权限使用理由的文案内容规范

当申请的权限为user_grant权限时，字段reason（申请权限的原因）必填。开发者需要在应用配置文件中，配置每一个需要使用的权限。

但在实际向用户弹窗申请授权时，user_grant权限将会以[权限组]的形式向用户申请。当前支持的权限组请查看[应用权限组列表]

reason字段的内容写作规范及建议

1. 保持句子简洁、不要加入多余的分割符号。
   建议句式 ：用于某事。
   示例 ：用于扫码拍照。
2. 用途描述的字串建议小于72个字符（即36个中文字符，UI界面显示大约为两行）。不能超过256个字符，以保证多语言适配的体验。
3. 如果不写，将展示默认的申请理由。
4. HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿

权限使用理由展示方式

权限使用理由有两个展示途径：授权弹窗界面和“设置（Settings）”界面。“设置”的具体路径：设置-隐私-权限管理-某应用某权限详情。

1. 如果是申请“电话、信息、日历、通讯录、通话记录”这五个权限组中的权限，根据工信部要求，将展示具体子权限的内容与用途。
   句式 ：包括子权限A和子权限B，用于某事。
   样例 ：用于获取通话状态和移动网络信息，用于安全运营和统计计费服务。
2. 如果是申请其他权限组中的权限，系统将使用权限组内当前被申请的第一个子权限的使用理由，作为该权限组的使用理由进行展示。组内的排序，固定按照权限管理内排列的权限组数组顺序。
   举例说明：权限组A = {权限A, 权限B, 权限C}；申请传入的权限是{权限C, 权限B}，界面将展示权限B的权限使用理由。
   审核编辑 黄宇