聲明權(quán)限
應(yīng)用在申請權(quán)限時,需要在項目的配置文件中,逐個聲明需要的權(quán)限,否則應(yīng)用將無法獲取授權(quán)。
在配置文件中聲明權(quán)限
應(yīng)用需要在module.json5配置文件的[requestPermissions]標(biāo)簽中聲明權(quán)限。
屬性 | 說明 開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md ] | 取值范圍 |
---|---|---|
name | 必須,填寫需要使用的權(quán)限名稱。 | 需為系統(tǒng)已定義的權(quán)限,取值范圍請參考[應(yīng)用權(quán)限列表] |
reason | 可選,當(dāng)申請的權(quán)限為user_grant權(quán)限時此字段必填,用于描述申請權(quán)限的原因。**說明:**該字段用于應(yīng)用上架校驗,當(dāng)申請的權(quán)限為user_grant權(quán)限時必填,并且需要進(jìn)行多語種適配。 | 使用string類資源引用。格式為$string: ***。 |
usedScene | 可選,當(dāng)申請的權(quán)限為user_grant權(quán)限時此字段必填。描述權(quán)限使用的場景由abilities和when組成。其中abilities可以配置為多個UIAbility組件,when表示調(diào)用時機。**說明:**默認(rèn)為可選,當(dāng)申請的權(quán)限為user_grant權(quán)限時,abilities標(biāo)簽必填,when標(biāo)簽可選。 | abilities:UIAbility或者ExtensionAbility組件的名稱。 when:inuse(使用時)、always(始終)。 |
聲明樣例
{
"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)申請的權(quán)限為user_grant權(quán)限時,字段reason(申請權(quán)限的原因)必填。開發(fā)者需要在應(yīng)用配置文件中,配置每一個需要使用的權(quán)限。
但在實際向用戶彈窗申請授權(quán)時,user_grant權(quán)限將會以[權(quán)限組]的形式向用戶申請。當(dāng)前支持的權(quán)限組請查看[應(yīng)用權(quán)限組列表]
reason字段的內(nèi)容寫作規(guī)范及建議
- 保持句子簡潔、不要加入多余的分割符號。
建議句式 :用于某事。
示例 :用于掃碼拍照。 - 用途描述的字串建議小于72個字符(即36個中文字符,UI界面顯示大約為兩行)。不能超過256個字符,以保證多語言適配的體驗。
- 如果不寫,將展示默認(rèn)的申請理由。
HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿
權(quán)限使用理由展示方式
權(quán)限使用理由有兩個展示途徑:授權(quán)彈窗界面和“設(shè)置(Settings)”界面?!霸O(shè)置”的具體路徑:設(shè)置-隱私-權(quán)限管理-某應(yīng)用某權(quán)限詳情。
- 如果是申請“電話、信息、日歷、通訊錄、通話記錄”這五個權(quán)限組中的權(quán)限,根據(jù)工信部要求,將展示具體子權(quán)限的內(nèi)容與用途。
句式 :包括子權(quán)限A和子權(quán)限B,用于某事。
樣例 :用于獲取通話狀態(tài)和移動網(wǎng)絡(luò)信息,用于安全運營和統(tǒng)計計費服務(wù)。 - 如果是申請其他權(quán)限組中的權(quán)限,系統(tǒng)將使用權(quán)限組內(nèi)當(dāng)前被申請的第一個子權(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};申請傳入的權(quán)限是{權(quán)限C, 權(quán)限B},界面將展示權(quán)限B的權(quán)限使用理由。
審核編輯 黃宇
-
框架
+關(guān)注
關(guān)注
0文章
404瀏覽量
17898 -
鴻蒙
+關(guān)注
關(guān)注
60文章
2620瀏覽量
44063
發(fā)布評論請先 登錄
鴻蒙開發(fā)接口Ability框架:【 (Context模塊)】

鴻蒙Ability Kit(程序框架服務(wù))【ServiceExtensionAbility】

鴻蒙原生應(yīng)用元服務(wù)-訪問控制(權(quán)限)開發(fā)場景與權(quán)限聲明
HarmonyOS NEXT應(yīng)用元服務(wù)開發(fā)Intents Kit(意圖框架服務(wù))綜述
鴻蒙APP開發(fā)鴻蒙權(quán)限請求框架
如何使用鴻蒙系統(tǒng)上權(quán)限請求框架桃夭
一款好用的鴻蒙系統(tǒng)上的權(quán)限請求框架
鴻蒙Ability Kit(程序框架服務(wù))【Ability內(nèi)頁面間的跳轉(zhuǎn)】

鴻蒙Ability Kit(程序框架服務(wù))【Ability與ServiceExtensionAbility通信】

鴻蒙Ability Kit(程序框架服務(wù))【應(yīng)用啟動框架AppStartup】
鴻蒙開發(fā)Ability Kit程序框架服務(wù):應(yīng)用權(quán)限管控概述 程序訪問控制

鴻蒙開發(fā)Ability Kit程序框架服務(wù):選擇申請權(quán)限的方式

鴻蒙開發(fā)Ability Kit程序訪問控制:對所有應(yīng)用開放

評論