聲明權(quán)限

應(yīng)用在申請權(quán)限時，需要在項目的配置文件中，逐個聲明需要的權(quán)限，否則應(yīng)用將無法獲取授權(quán)。

在配置文件中聲明權(quán)限

應(yīng)用需要在module.json5配置文件的[requestPermissions]標簽中聲明權(quán)限。

聲明樣例

{
  "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"
        }
      }
    ]
  }
}

權(quán)限使用理由的文案內(nèi)容規(guī)范

當申請的權(quán)限為user_grant權(quán)限時，字段reason（申請權(quán)限的原因）必填。開發(fā)者需要在應(yīng)用配置文件中，配置每一個需要使用的權(quán)限。

但在實際向用戶彈窗申請授權(quán)時，user_grant權(quán)限將會以[權(quán)限組]的形式向用戶申請。當前支持的權(quán)限組請查看[應(yīng)用權(quán)限組列表]

reason字段的內(nèi)容寫作規(guī)范及建議

1. 保持句子簡潔、不要加入多余的分割符號。
   建議句式 ：用于某事。
   示例 ：用于掃碼拍照。
2. 用途描述的字串建議小于72個字符（即36個中文字符，UI界面顯示大約為兩行）。不能超過256個字符，以保證多語言適配的體驗。
3. 如果不寫，將展示默認的申請理由。
4. HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿

權(quán)限使用理由展示方式

權(quán)限使用理由有兩個展示途徑：授權(quán)彈窗界面和“設(shè)置（Settings）”界面。“設(shè)置”的具體路徑：設(shè)置-隱私-權(quán)限管理-某應(yīng)用某權(quán)限詳情。

1. 如果是申請“電話、信息、日歷、通訊錄、通話記錄”這五個權(quán)限組中的權(quán)限，根據(jù)工信部要求，將展示具體子權(quán)限的內(nèi)容與用途。
   句式 ：包括子權(quán)限A和子權(quán)限B，用于某事。
   樣例 ：用于獲取通話狀態(tài)和移動網(wǎng)絡(luò)信息，用于安全運營和統(tǒng)計計費服務(wù)。
2. 如果是申請其他權(quán)限組中的權(quán)限，系統(tǒng)將使用權(quán)限組內(nèi)當前被申請的第一個子權(quán)限的使用理由，作為該權(quán)限組的使用理由進行展示。組內(nèi)的排序，固定按照權(quán)限管理內(nèi)排列的權(quán)限組數(shù)組順序。
   舉例說明：權(quán)限組A = {權(quán)限A, 權(quán)限B, 權(quán)限C}；申請傳入的權(quán)限是{權(quán)限C, 權(quán)限B}，界面將展示權(quán)限B的權(quán)限使用理由。
   審核編輯 黃宇