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

場(chǎng)景介紹

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

權(quán)限申請(qǐng)

開發(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)限申請(qǐng)格式采用數(shù)組格式，可支持同時(shí)申請(qǐng)多個(gè)權(quán)限，權(quán)限個(gè)數(shù)最多不能超過 1024 個(gè)。

如果聲明使用的權(quán)限的 grantMode 是 system_grant， 則權(quán)限會(huì)在當(dāng)應(yīng)用安裝的時(shí)候被自動(dòng)授予。

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

說明

對(duì)于授權(quán)方式為 user_grant 的權(quán)限，每一次執(zhí)行需要這一權(quán)限的操作時(shí)，都需要檢查自身是否有該權(quán)限。當(dāng)自身具有權(quán)限時(shí)，才可繼續(xù)執(zhí)行，否則應(yīng)用需要請(qǐng)求用戶授予權(quán)限。示例參見[動(dòng)態(tài)申請(qǐng)權(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ù)組格式，可支持同時(shí)定義多個(gè)權(quán)限，自定義的權(quán)限個(gè)數(shù)最多不能超過 1024個(gè)。權(quán)限定義的字段描述詳見[表2]。

訪問權(quán)限控制

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

在 config.json 中填寫“abilities”到“permissions”字段，即只有擁有該權(quán)限的應(yīng)用可訪問此Ability。下面的例子表明只有擁有“ohos.permission.CAMERA”權(quán)限的應(yīng)用可以訪問此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 實(shí)現(xiàn)中，如需要對(duì)特定接口對(duì)調(diào)用者做訪問控制，可在服務(wù)側(cè)的接口實(shí)現(xiàn)中，主動(dòng)通過 verifyCallingPermission、 verifyCallingOrSelfPermission 來檢查訪問者是否擁有所需要的權(quán)限。

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

API接口說明

動(dòng)態(tài)申請(qǐng)權(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 接口查詢應(yīng)用是否已被授予該權(quán)限。

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

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

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

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

樣例代碼如下：

   if (verifySelfPermission("ohos.permission.CAMERA") != IBundleManager.PERMISSION_GRANTED) {
       // 應(yīng)用未被授予權(quán)限
       if (canRequestPermission("ohos.permission.CAMERA")) {
           // 是否可以申請(qǐng)彈框授權(quán)(首次申請(qǐng)或者用戶未選擇禁止且不再提示)
           requestPermissionsFromUser(
                   new String[] { "ohos.permission.CAMERA" } , MY_PERMISSIONS_REQUEST_CAMERA);
       } else {
           // 顯示應(yīng)用需要權(quán)限的理由，提示用戶進(jì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)限被授予
                   // 注意：因時(shí)間差導(dǎo)致接口權(quán)限檢查時(shí)有無權(quán)限，所以對(duì)那些因無權(quán)限而拋異常的接口進(jìn)行異常捕獲處理
               } else {
                   // 權(quán)限被拒絕
               }
               return;
           }
       }
   }