鴻蒙OS 權(quán)限開發(fā)指導

場景介紹

HarmonyOS 支持開發(fā)者自定義權(quán)限來保護能力或接口，同時開發(fā)者也可申請權(quán)限來訪問受權(quán)限保護的對象。

權(quán)限申請

開發(fā)者需要在 config.json 文件中的“reqPermissions”字段中聲明所需要的權(quán)限。

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

權(quán)限申請格式采用數(shù)組格式，可支持同時申請多個權(quán)限，權(quán)限個數(shù)最多不能超過 1024 個。

如果聲明使用的權(quán)限的 grantMode 是 system_grant， 則權(quán)限會在當應用安裝的時候被自動授予。

如果聲明使用的權(quán)限的 grantMode 是 user_grant，則必須經(jīng)用戶手動授權(quán)（用戶在彈框中授權(quán)或進入權(quán)限設(shè)置界面授權(quán)）才可使用。用戶會看到 reason 字段中填寫的理由，來幫助用戶決定是否給予授權(quán)。

說明

對于授權(quán)方式為 user_grant 的權(quán)限，每一次執(zhí)行需要這一權(quán)限的操作時，都需要檢查自身是否有該權(quán)限。當自身具有權(quán)限時，才可繼續(xù)執(zhí)行，否則應用需要請求用戶授予權(quán)限。示例參見[動態(tài)申請權(quán)限開發(fā)步驟]。

自定義權(quán)限

開發(fā)者需要在 config.json 文件中的“defPermissions”字段中自定義所需的權(quán)限：

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

權(quán)限定義格式采用數(shù)組格式，可支持同時定義多個權(quán)限，自定義的權(quán)限個數(shù)最多不能超過 1024個。權(quán)限定義的字段描述詳見[表2]。

訪問權(quán)限控制

• Ability的訪問權(quán)限控制

在 config.json 中填寫“abilities”到“permissions”字段，即只有擁有該權(quán)限的應用可訪問此Ability。下面的例子表明只有擁有“ohos.permission.CAMERA”權(quán)限的應用可以訪問此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 接口的訪問權(quán)限控制

在 Ability 實現(xiàn)中，如需要對特定接口對調(diào)用者做訪問控制，可在服務側(cè)的接口實現(xiàn)中，主動通過 verifyCallingPermission、 verifyCallingOrSelfPermission 來檢查訪問者是否擁有所需要的權(quán)限。

  if (verifyCallingPermission("ohos.permission.CAMERA") != IBundleManager.PERMISSION_GRANTED) {
      // 調(diào)用者無權(quán)限，做錯誤處理
  }
      // 調(diào)用者權(quán)限校驗通過，開始提供服務

API接口說明

動態(tài)申請權(quán)限開發(fā)步驟

1. 在 config.json 文件中聲明所需要的權(quán)限。

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

1. 使用 ohos.app.Context.verifySelfPermission 接口查詢應用是否已被授予該權(quán)限。

• 如果已被授予權(quán)限，可以結(jié)束權(quán)限申請流程。
• 如果未被授予權(quán)限，繼續(xù)執(zhí)行下一步。

1. 使用 canRequestPermission 查詢是否可動態(tài)申請。

• 如果不可動態(tài)申請，說明已被用戶或系統(tǒng)永久禁止授權(quán)，可以結(jié)束權(quán)限申請流程。
• 如果可動態(tài)申請，繼續(xù)執(zhí)行下一步。

1. 使用 requestPermissionFromUser 動態(tài)申請權(quán)限，通過回調(diào)函數(shù)接受授予結(jié)果。

樣例代碼如下：

   if (verifySelfPermission("ohos.permission.CAMERA") != IBundleManager.PERMISSION_GRANTED) {
       // 應用未被授予權(quán)限
       if (canRequestPermission("ohos.permission.CAMERA")) {
           // 是否可以申請彈框授權(quán)(首次申請或者用戶未選擇禁止且不再提示)
           requestPermissionsFromUser(
                   new String[] { "ohos.permission.CAMERA" } , MY_PERMISSIONS_REQUEST_CAMERA);
       } else {
           // 顯示應用需要權(quán)限的理由，提示用戶進入設(shè)置授權(quán)
       }
   } else {
       // 權(quán)限已被授予
   }

    
   @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) {
                   // 權(quán)限被授予
                   // 注意：因時間差導致接口權(quán)限檢查時有無權(quán)限，所以對那些因無權(quán)限而拋異常的接口進行異常捕獲處理
               } else {
                   // 權(quán)限被拒絕
               }
               return;
           }
       }
   }