聲明權(quán)限

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

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

應(yīng)用需要在module.json5配置文件的[requestPermissions]標(biāo)簽中聲明權(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ī)范

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

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

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

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

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

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

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