鴻蒙APP開(kāi)發(fā)鴻蒙權(quán)限請(qǐng)求框架

關(guān)于 HarmonyOS 的動(dòng)態(tài)授權(quán)的常規(guī)操作流程和代碼我之前寫(xiě)過(guò)一篇文章：《鴻蒙動(dòng)態(tài)權(quán)限申請(qǐng)完整規(guī)范流程和操作詳解》。

文章地址如下：

https://harmonyos.51cto.com/posts/5165

權(quán)限控制是在進(jìn)行 HarmonyOS 應(yīng)用開(kāi)發(fā)中非常重要的一個(gè)環(huán)節(jié)，幾乎所有的商業(yè)應(yīng)用中都會(huì)涉及到。

我們?cè)谠?jīng)使用的 Android app 應(yīng)用中經(jīng)常會(huì)遇到一些 app 會(huì)彈出各種敏感權(quán)限授權(quán)窗口提示用戶授權(quán)。

有些 app（特別是流氓應(yīng)用）經(jīng)常會(huì)在第一次打開(kāi) app 的時(shí)候就提醒用戶授予所有需要的權(quán)限。

甚至一些權(quán)限跟 app 功能根本不相關(guān)（比如讀取通訊錄等），如果不授權(quán)則直接不讓你使用該 app，我遇到這類流氓應(yīng)用一般果斷卸載。

而真正的開(kāi)發(fā)過(guò)程中我們?cè)跈?quán)限申請(qǐng)的時(shí)候一般要遵循以下 3 個(gè)原則：

最小權(quán)限集，即應(yīng)用中確實(shí)需要的權(quán)限才進(jìn)行申請(qǐng)。

需要用到 XX 權(quán)限時(shí)才進(jìn)行申請(qǐng)，即并不是 app 開(kāi)始的時(shí)候一次性申請(qǐng)所有權(quán)限，而是需要用到 XX 特定功能必須要授權(quán)才能使用的時(shí)候（比如調(diào)用照相機(jī)），這個(gè)時(shí)候才申請(qǐng)?jiān)撎囟?quán)限。

未獲取用戶授權(quán)的話依然能使用應(yīng)用大部分功能，只是必須授權(quán)的功能無(wú)法使用。

下面我針對(duì)敏感權(quán)限申請(qǐng)更好的復(fù)用，編寫(xiě)了一個(gè)第三方開(kāi)源組件，取名為 XdwPermissionsLib。

具體項(xiàng)目源碼請(qǐng)見(jiàn)：

https://gitee.com/xdw1019/XdwPermissionsLib

XdwPermissionsLib 介紹

鴻蒙權(quán)限請(qǐng)求框架，提供一個(gè)符合正規(guī)權(quán)限調(diào)用流程的框架并基于鏈?zhǔn)秸{(diào)用（這里簡(jiǎn)稱 strong 模式），同時(shí)提供一個(gè)并不推薦使用的簡(jiǎn)單權(quán)限框架（簡(jiǎn)稱 lazy 模式）。

strong 模式：正式項(xiàng)目推薦使用該模式。正規(guī)權(quán)限處理流程，用戶需要檢驗(yàn)權(quán)限并且處理校驗(yàn)結(jié)果的回調(diào)。

lazy 模式：該模式下開(kāi)發(fā)者幾乎不用去編寫(xiě)請(qǐng)求權(quán)限的代碼，特別是不處理回調(diào)。

該模式不推薦在正式項(xiàng)目中使用，可以用于平時(shí)編寫(xiě)某些 demo 又不想處理權(quán)限的場(chǎng)景下。

當(dāng)然有些 app 不在乎用戶體驗(yàn)，只要不授權(quán)就不讓使用的情況可以使用該模式。

動(dòng)態(tài)申請(qǐng)權(quán)限流程圖如下：

使用說(shuō)明

①Strong 模式

引用：

方式一：通過(guò) mylibrary 模塊生成 har 包，添加 har 包到 libs 文件夾內(nèi)

方式二：maven 引入（待后續(xù)上傳到 maven 中心倉(cāng)庫(kù)再支持）

定義權(quán)限組，比如：

//定義需要?jiǎng)討B(tài)申請(qǐng)的權(quán)限組，可以是一個(gè)或多個(gè)權(quán)限。這里的權(quán)限還必須要在config.json中進(jìn)行配置

private String［］ permissions = {

// 存儲(chǔ)權(quán)限

SystemPermission.WRITE_USER_STORAGE，

// 相機(jī)權(quán)限

SystemPermission.CAMERA

};

在需要觸發(fā)權(quán)限申請(qǐng)的地方調(diào)用如下代碼：

//開(kāi)始動(dòng)態(tài)申請(qǐng)權(quán)限，鏈?zhǔn)秸{(diào)用。//實(shí)際開(kāi)發(fā)中申請(qǐng)權(quán)限的動(dòng)作應(yīng)該放到需要用到該權(quán)限的操作中觸發(fā)，比如點(diǎn)擊某個(gè)按鈕調(diào)起相機(jī) StrongPermissionsUtils.getInstance（this）.checkPermissions（this，permissions）.setPermissionStateListener（new StrongPermissionsUtils.PermissionStateListener（） {

@Override

public void onPermissionGranted（） {

//授權(quán)成功之后的回調(diào)

//此處根據(jù)自己的實(shí)際業(yè)務(wù)編寫(xiě)業(yè)務(wù)邏輯，此處用toast進(jìn)行演示

ToastUtil.toast（getContext（），“授權(quán)成功”）;

}

@Override

public void onPermissionDenied（boolean isDisabledPrompt） {

//授權(quán)拒絕之后的回調(diào)

//此處根據(jù)自己的實(shí)際業(yè)務(wù)編寫(xiě)業(yè)務(wù)邏輯，此處用toast進(jìn)行演示

if（isDisabledPrompt）{

ToastUtil.toast（getContext（），“您之前拒絕了授權(quán)并且禁止系統(tǒng)再提示，需要手動(dòng)進(jìn)入系統(tǒng)設(shè)置頁(yè)面開(kāi)啟”）;

}else{

ToastUtil.toast（getContext（），“您拒絕了授權(quán)”）;

}

}

}）;

在當(dāng)前的 ability 重寫(xiě) onRequestPermissionsFromUserResult 方法，代碼如下：

@Overridepublic void onRequestPermissionsFromUserResult（int requestCode， String［］ permissions， int［］ grantResults） {

super.onRequestPermissionsFromUserResult（requestCode， permissions， grantResults）;

//鑒權(quán)之后的回調(diào)，必須調(diào)用

StrongPermissionsUtils.getInstance（this）.onRequestPermissionsResult（requestCode， permissions， grantResults）;

}

②Lazy 模式

引用：

方式一：通過(guò) mylibrary 模塊生成 har 包，添加 har 包到 libs 文件夾內(nèi)

方式二：maven 引入（待后續(xù)上傳到 maven 中心倉(cāng)庫(kù)再支持）

將需要調(diào)用的 Ability 繼承 LazyPermissionAblity，如下：

public class MainAbility extends LazyPermissionAblity {

在當(dāng)前 Ability 中定義權(quán)限組，并且在 onStart 方法的第一行調(diào)用 setPermissions 方法。

代碼如下：

public class MainAbility extends LazyPermissionAblity {

//定義需要?jiǎng)討B(tài)申請(qǐng)的權(quán)限組，可以是一個(gè)或多個(gè)權(quán)限。這里的權(quán)限還必須要在config.json中進(jìn)行配置

private String［］ permissions = {

// 存儲(chǔ)權(quán)限

SystemPermission.WRITE_USER_STORAGE，

// 相機(jī)權(quán)限

SystemPermission.CAMERA

};

@Override

public void onStart（Intent intent） {

//lazy模式下，setPermissions的代碼調(diào)用必須放在onStart的第一行

super.setPermissions（permissions）;

super.onStart（intent）;

super.setMainRoute（MainAbilitySlice.class.getName（））;

}

}

工程結(jié)構(gòu)說(shuō)明

工程中總共有三個(gè) module，分別為：

mylibrary：自定義的第三方權(quán)限庫(kù)，供外部項(xiàng)目調(diào)用。

entry：用來(lái)演示 mylibrary 庫(kù)中 strong 模式下的權(quán)限調(diào)用。

LazySample：用來(lái)演示 mylibrary 庫(kù)中 lazy 模式下的權(quán)限調(diào)用。

責(zé)任編輯：haq