鸿蒙OS 权限开发指导

场景介绍

HarmonyOS 支持开发者自定义权限来保护能力或接口，同时开发者也可申请权限来访问受权限保护的对象。

权限申请

开发者需要在 config.json 文件中的“reqPermissions”字段中声明所需要的权限。

{
    "reqPermissions": [{
        "name": "ohos.permission.CAMERA",
        "reason": "$string:permreason_camera",
        "usedScene": {
            "ability": ["com.mycamera.Ability", "com.mycamera.AbilityBackground"],
            "when": "always"
        }
    },{
    ...
    }]
}

权限申请格式采用数组格式，可支持同时申请多个权限，权限个数最多不能超过 1024 个。

如果声明使用的权限的 grantMode 是 system_grant， 则权限会在当应用安装的时候被自动授予。

如果声明使用的权限的 grantMode 是 user_grant，则必须经用户手动授权（用户在弹框中授权或进入权限设置界面授权）才可使用。用户会看到 reason 字段中填写的理由，来帮助用户决定是否给予授权。

说明

对于授权方式为 user_grant 的权限，每一次执行需要这一权限的操作时，都需要检查自身是否有该权限。当自身具有权限时，才可继续执行，否则应用需要请求用户授予权限。示例参见[动态申请权限开发步骤]。

自定义权限

开发者需要在 config.json 文件中的“defPermissions”字段中自定义所需的权限：

{
    "defPermissions": [{
        "name": "com.myability.permission.MYPERMISSION",
        "grantMode": "system_grant",
        "availableScope": ["signature"]
    }, {
    ...
    }]
}

权限定义格式采用数组格式，可支持同时定义多个权限，自定义的权限个数最多不能超过 1024个。权限定义的字段描述详见[表2]。

访问权限控制

• Ability的访问权限控制

在 config.json 中填写“abilities”到“permissions”字段，即只有拥有该权限的应用可访问此Ability。下面的例子表明只有拥有“ohos.permission.CAMERA”权限的应用可以访问此ability。

  "abilities": [{
          "name": ".MainAbility",
          "description": "$string:description_main_ability",
          "icon": "$media:hiworld.png",
          "label": "HiCamera",
          "launchType": "standard",
          "orientation": "portrait",
          "visible": false,
          "permissions": [
              "ohos.permission.CAMERA"
          ],
      }]

• Ability 接口的访问权限控制

在 Ability 实现中，如需要对特定接口对调用者做访问控制，可在服务侧的接口实现中，主动通过 verifyCallingPermission、 verifyCallingOrSelfPermission 来检查访问者是否拥有所需要的权限。

  if (verifyCallingPermission("ohos.permission.CAMERA") != IBundleManager.PERMISSION_GRANTED) {
      // 调用者无权限，做错误处理
  }
      // 调用者权限校验通过，开始提供服务

API接口说明

动态申请权限开发步骤

1. 在 config.json 文件中声明所需要的权限。

   {
       " reqPermissions": [{
           "name": "ohos.permission.CAMERA",
           "reason": "$string:permreason_camera",
           "usedScene": {
               "ability": ["com.mycamera.Ability", "com.mycamera.AbilityBackground"],
               "when": "always"}
           }, {
           ...
           }]
       }]
   }

1. 使用 ohos.app.Context.verifySelfPermission 接口查询应用是否已被授予该权限。

• 如果已被授予权限，可以结束权限申请流程。
• 如果未被授予权限，继续执行下一步。

1. 使用 canRequestPermission 查询是否可动态申请。

• 如果不可动态申请，说明已被用户或系统永久禁止授权，可以结束权限申请流程。
• 如果可动态申请，继续执行下一步。

1. 使用 requestPermissionFromUser 动态申请权限，通过回调函数接受授予结果。

样例代码如下：

   if (verifySelfPermission("ohos.permission.CAMERA") != IBundleManager.PERMISSION_GRANTED) {
       // 应用未被授予权限
       if (canRequestPermission("ohos.permission.CAMERA")) {
           // 是否可以申请弹框授权(首次申请或者用户未选择禁止且不再提示)
           requestPermissionsFromUser(
                   new String[] { "ohos.permission.CAMERA" } , MY_PERMISSIONS_REQUEST_CAMERA);
       } else {
           // 显示应用需要权限的理由，提示用户进入设置授权
       }
   } else {
       // 权限已被授予
   }

    
   @override
   public void onRequestPermissionsFromUserResult (int requestCode, String[] permissions, int[] grantResults){
       switch (requestCode) {
           case MY_PERMISSIONS_REQUEST_CAMERA: {
               // 匹配requestPermissions的requestCode
               if (grantResults.length > 0
                   && grantResults[0] == IBundleManager.PERMISSION_GRANTED) {
                   // 权限被授予
                   // 注意：因时间差导致接口权限检查时有无权限，所以对那些因无权限而抛异常的接口进行异常捕获处理
               } else {
                   // 权限被拒绝
               }
               return;
           }
       }
   }