選擇申請權(quán)限的方式

應(yīng)用在訪問數(shù)據(jù)或者執(zhí)行操作時，需要評估該行為是否需要應(yīng)用具備相關(guān)的權(quán)限。如果確認(rèn)需要目標(biāo)權(quán)限，則需要在應(yīng)用安裝包中申請目標(biāo)權(quán)限。

每一個權(quán)限的權(quán)限等級、授權(quán)方式不同，申請權(quán)限的方式也不同，開發(fā)者在申請權(quán)限前，需要先根據(jù)以下流程判斷應(yīng)用能否申請目標(biāo)權(quán)限。

上圖的數(shù)字標(biāo)注，請參考以下說明：

• 標(biāo)注1：應(yīng)用APL等級與權(quán)限等級的匹配關(guān)系請參考[APL等級說明]。
• 標(biāo)注2：權(quán)限的授權(quán)方式分為user_grant（用戶授權(quán)）和system_grant（系統(tǒng)授權(quán)），具體請參考[授權(quán)方式說明]。
• 開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
  • 如果目標(biāo)權(quán)限是system_grant類型，開發(fā)者在進(jìn)行權(quán)限申請后，系統(tǒng)會在安裝應(yīng)用時自動為其進(jìn)行權(quán)限預(yù)授予，開發(fā)者不需要做其他操作即可使用權(quán)限。
  • 在應(yīng)用需要獲取user_grant權(quán)限時，請完成以下步驟：
    1. 在配置文件中，聲明應(yīng)用需要請求的權(quán)限。
    2. 將應(yīng)用中需要申請權(quán)限的目標(biāo)對象與對應(yīng)目標(biāo)權(quán)限進(jìn)行關(guān)聯(lián)，讓用戶明確地知道，哪些操作需要用戶向應(yīng)用授予指定的權(quán)限。
    3. 運行應(yīng)用時，在用戶觸發(fā)訪問操作目標(biāo)對象時應(yīng)該調(diào)用接口，精準(zhǔn)觸發(fā)動態(tài)授權(quán)彈框。該接口的內(nèi)部會檢查當(dāng)前用戶是否已經(jīng)授權(quán)應(yīng)用所需的權(quán)限，如果當(dāng)前用戶尚未授予應(yīng)用所需的權(quán)限，該接口會拉起動態(tài)授權(quán)彈框，向用戶請求授權(quán)。
    4. 檢查用戶的授權(quán)結(jié)果，確認(rèn)用戶已授權(quán)才可以進(jìn)行下一步操作。
• 標(biāo)注3：應(yīng)用可以通過ACL（訪問控制列表）方式申請高級別的權(quán)限。

應(yīng)用可根據(jù)目標(biāo)權(quán)限的開放范圍、授權(quán)方式，參考以下操作路徑申請對應(yīng)權(quán)限。

normal等級應(yīng)用申請權(quán)限的方式

說明：

• 如果system_basic等級的權(quán)限，ACL使能為false，則normal等級應(yīng)用無法申請該權(quán)限。
• 當(dāng)前可通過DevEco Studio完成[ACL方式跨級別申請權(quán)限]，但該方法僅用于應(yīng)用調(diào)試階段使用，不可用于發(fā)布上架應(yīng)用市場。如果需要開發(fā)商用版本的應(yīng)用，請在對應(yīng)的應(yīng)用市場進(jìn)行發(fā)布證書和Profile文件的申請。

system_basic等級應(yīng)用申請權(quán)限的方式

如果應(yīng)用需要將自身的APL等級聲明為system_basic及以上，在開發(fā)應(yīng)用安裝包時，需要修改應(yīng)用的HarmonyAppProvision配置文件即SDK目錄下的“Toolchains / _{Version} _/ lib / UnsgnedReleasedProfileTemplate.json”文件），并重新進(jìn)行應(yīng)用簽名。

修改方式：

HarmonyAppProvision配置文件示例如下所示，修改"bundle-info" > "apl" 字段。

"bundle-info" : {
    // ...
    "apl": "system_basic",
    // ...
},

說明： 直接修改HarmonyAppProvision配置文件的方式，僅用于應(yīng)用調(diào)試階段使用，不可用于發(fā)布上架應(yīng)用市場。如果需要開發(fā)商用版本的應(yīng)用，請在對應(yīng)的應(yīng)用市場進(jìn)行發(fā)布證書和Profile文件的申請。

審核編輯 黃宇