一款好用的鴻蒙系統(tǒng)上的權(quán)限請(qǐng)求框架

桃夭是鴻蒙系統(tǒng)上的一款權(quán)限請(qǐng)求框架，對(duì)請(qǐng)求權(quán)限的代碼進(jìn)行高度封裝，極大的簡(jiǎn)化了申請(qǐng)權(quán)限的代碼邏輯，同時(shí)支持在 Ability、FractionAbility、AbilitySlice、Fractiion 里面申請(qǐng)權(quán)限。

建議大家把源碼下載下來看看：

https://gitee.com/zhongte/TaoYao

申請(qǐng)權(quán)限

申請(qǐng)權(quán)限的一般步驟如下：

• 判斷是否有權(quán)限，如果有權(quán)限，直接進(jìn)行下一步。

• 如果沒有權(quán)限，可以彈窗告知用戶申請(qǐng)權(quán)限的原因。

• 彈窗告知用戶后，如果用戶同意申請(qǐng)權(quán)限，則判斷用戶是否點(diǎn)擊了不再提醒。

• 如果用戶沒有點(diǎn)擊不再提醒，則開始申請(qǐng)權(quán)限。

• 如果用戶點(diǎn)擊了不再提醒，則彈窗告知用戶去設(shè)置頁面開啟權(quán)限，用戶點(diǎn)擊彈窗后，跳轉(zhuǎn)到設(shè)置頁面。

• 重寫 onRequestPermissionsFromUserResult 方法，判斷用戶是否授予權(quán)限。

每次申請(qǐng)權(quán)限的時(shí)候，都需要經(jīng)過以上幾個(gè)步驟，當(dāng)申請(qǐng)的權(quán)限越來越多，大量的重復(fù)代碼就出現(xiàn)了。

為了減少重復(fù)代碼，我封裝了一個(gè)權(quán)限請(qǐng)求框架，權(quán)限請(qǐng)求框架取名為桃夭。

桃夭的使用方式

如下代碼，先添加依賴，然后你只需要告知權(quán)限請(qǐng)求框架你需要什么權(quán)限，權(quán)限請(qǐng)求框架就會(huì)告知你權(quán)限申請(qǐng)成功還是失敗。

你不需要手動(dòng)判斷是否有權(quán)限，不需要彈窗告知用戶申請(qǐng)權(quán)限的原因，不需要判斷用戶是否點(diǎn)擊了不再提醒，不需要跳轉(zhuǎn)設(shè)置頁面讓用戶開啟權(quán)限，不需要重寫 onRequestPermissionsFromUserResult 方法。

框架把這些代碼邏輯都給做了，你只需要關(guān)注權(quán)限申請(qǐng)成功還是失敗。申請(qǐng)權(quán)限變得如此之簡(jiǎn)單。

添加依賴：

api'io.gitee.zhongte1.0.1'

申請(qǐng)權(quán)限：

//申請(qǐng)多設(shè)備協(xié)同權(quán)限
EasyPermission.requestPermission(this,EasyPermission.DISTRIBUTED_DATASYNC,newPermissionAction(){
@Override
publicvoidonGranted(Listpermissions){
//權(quán)限申請(qǐng)成功

}

@Override
publicvoidonDenied(Listpermissions){
//權(quán)限申請(qǐng)失敗
}
},SystemPermission.DISTRIBUTED_DATASYNC);

申請(qǐng)權(quán)限的時(shí)候可能會(huì)涉及到兩個(gè)彈窗，一個(gè)彈窗是用來告知用戶申請(qǐng)權(quán)限的原因，另一個(gè)彈窗是用來告知用戶去設(shè)置頁面開啟權(quán)限。

這兩個(gè)彈窗在不同的應(yīng)用里面可能長(zhǎng)得不一樣，所以這兩個(gè)彈窗并沒有被封裝到桃夭框架里面，而是需要使用者根據(jù)你的彈窗樣式對(duì)桃夭進(jìn)行二次封裝。

我在源碼里面對(duì)桃夭框架進(jìn)行了二次封裝，大家可以把源碼下載下來，參考下我是如何對(duì)桃夭框架進(jìn)行二次封裝的。二次封裝完成后，就可以愉快的使用上面的代碼申請(qǐng)權(quán)限了。

實(shí)現(xiàn)原理

①檢測(cè)申請(qǐng)的權(quán)限是否在配置文件中聲明

申請(qǐng)的權(quán)限必須在配置文件中聲明，否則桃夭會(huì)直接拋異常。如何檢測(cè)申請(qǐng)的權(quán)限是否在配置文件中聲明。

如下代碼，獲取 bundleManager 對(duì)象，通過 bundleManager 對(duì)象獲取應(yīng)用信息，之后就可以獲取應(yīng)用在配置文件中聲明的權(quán)限了。

/**
*獲取在配置文件中聲明的權(quán)限
*
*@paramcontext上下文
*@return在配置文件中聲明的權(quán)限
*/
privateListgetConfigPermissions(Contextcontext){
//獲取bundleManager對(duì)象
IBundleManagerbundleManager=context.getBundleManager();
StringbundleName=context.getBundleName();
try{
//獲取應(yīng)用信息
BundleInfobundleInfo=bundleManager.getBundleInfo(bundleName,IBundleManager.GET_BUNDLE_WITH_REQUESTED_PERMISSION);
//獲取應(yīng)用在配置文件中聲明的權(quán)限
ListreqPermissionDetails=bundleInfo.reqPermissions;
if(reqPermissionDetails==null||reqPermissionDetails.isEmpty()){
thrownewIllegalStateException("請(qǐng)?jiān)谂渲梦募新暶饕暾?qǐng)的權(quán)限");
}
returnreqPermissionDetails;
}catch(RemoteExceptione){
e.printStackTrace();
}
returnnewArrayList<>();
}

獲取到在配置文件中聲明的權(quán)限后，就可以判斷申請(qǐng)的權(quán)限是否在配置文件中了。

/**
*檢查申請(qǐng)的權(quán)限是否在配置文件中聲明
*
*@parampermissions要申請(qǐng)的權(quán)限
*/
privatevoidcheckPermissions(String...permissions){
if(permissions==null||permissions.length==0){
thrownewIllegalArgumentException("請(qǐng)至少申請(qǐng)一個(gè)權(quán)限");
}
//獲取在配置文件中聲明的權(quán)限
mReqPermissions=getConfigPermissions(mOrigin.getContext());
if(mReqPermissions.isEmpty()){
thrownewIllegalStateException("請(qǐng)?jiān)谂渲梦募新暶饕暾?qǐng)的權(quán)限");
}
for(Stringtarget:permissions){
if(!mReqPermissions.contains(target)){
//沒有在配置中聲明要申請(qǐng)的權(quán)限，直接拋異常
thrownewIllegalStateException(String.format("%1$s權(quán)限沒有配置文件中聲明",target));
}
}
}

②判斷是否有權(quán)限

檢測(cè)完權(quán)限是否在配置中聲明后，就可以判斷是否有權(quán)限了。這里就是通過上下文對(duì)象的 verifySelfPermission 方法來判斷是否有權(quán)限，如果沒有權(quán)限，可以彈窗告知用戶申請(qǐng)的原因。

/**
*是否有權(quán)限
*
*@paramcontext
*@parampermissions
*@return
*/
@Override
publicbooleanhasPermission(Contextcontext,Listpermissions){
for(Stringpermission:permissions){
intresult=context.verifySelfPermission(permission);
if(result==IBundleManager.PERMISSION_DENIED){
//沒有權(quán)限
returnfalse;
}
}
returntrue;
}

③判斷用戶是否點(diǎn)擊了不再提醒

通過上下文對(duì)象的 canRequestPermission 方法來判斷用戶是否點(diǎn)擊了不再提醒。

/**
*用戶是否點(diǎn)擊了不在提醒
*
*@parampermission權(quán)限
*@return
*/
@Override
publicbooleancanRequestPermission(Stringpermission){
returnmContext.canRequestPermission(permission);
}

④跳轉(zhuǎn)到設(shè)置頁面

如果用戶點(diǎn)擊了不再提醒，則可以跳轉(zhuǎn)到設(shè)置頁面讓用戶開啟權(quán)限。

/**
*跳轉(zhuǎn)到設(shè)置頁面
*/
@Override
publicvoidgotoSetting(){
try{
Intentintent=newIntent();
intent.setAction(IntentConstants.ACTION_APPLICATION_DETAILS_SETTINGS);
intent.setUri(Uri.parse("package:"+mOrigin.getContext().getBundleName()));
mOrigin.startAbility(intent);
}catch(Exceptione){
e.printStackTrace();
}
}

⑤啟動(dòng)透明的 Ability 申請(qǐng)權(quán)限

如果沒有權(quán)限，用戶頁面沒有點(diǎn)擊不再提醒，那就可以申請(qǐng)權(quán)限了。為了不讓調(diào)用者重寫 onRequestPermissionsFromUserResult 方法，桃夭內(nèi)部啟動(dòng)了一個(gè) Ability。

如下代碼：

/**
*開啟一個(gè)透明的Ability來申請(qǐng)權(quán)限，這樣外界就不需要重寫onRequestPermissionsFromUserResult方法
*/
publicclassPermissionAbilityextendsAbility{

privatestaticfinalintREQUEST_CODE=0X10;
publicstaticfinalStringKEY_PERMISSION="key_permission";
publicstaticfinalStringKEY_TYPE="key_type";
publicstaticfinalStringSENSITIVE_PERMISSION="sensitive_permission";

@Override
publicvoidonStart(Intentintent){
super.onStart(intent);
getWindow().setTransparent(true);
super.setUIContent(ResourceTable.Layout_ability_permission);
Listpermissions=intent.getSerializableParam(KEY_PERMISSION);
StringpermissionType=intent.getStringParam(KEY_TYPE);
//請(qǐng)求權(quán)限
requestPermissionsFromUser(permissions.toArray(newString[0]),REQUEST_CODE);
}

@Override
publicvoidonRequestPermissionsFromUserResult(intrequestCode,String[]permissions,int[]grantResults){
super.onRequestPermissionsFromUserResult(requestCode,permissions,grantResults);
//權(quán)限的回調(diào)方法
Postman.send(permissions,grantResults);
terminateAbility();
}

@Override
protectedvoidonAbilityResult(intrequestCode,intresultCode,IntentresultData){
super.onAbilityResult(requestCode,resultCode,resultData);
}
}

直接啟動(dòng)一個(gè) Ability 會(huì)發(fā)生頁面跳轉(zhuǎn)，為了不讓頁面發(fā)生跳轉(zhuǎn)，這里啟動(dòng)了一個(gè)透明的 Ability。

如何將 Ability 設(shè)置透明，如下代碼。在 abilities 節(jié)點(diǎn)添加 metaData，這里最關(guān)鍵的是 Translucent，也就是透明。

"abilities":[
{
"orientation":"unspecified",
"name":"com.poetry.taoyao.ability.PermissionAbility",
"icon":"$media:icon",
"description":"$string:permissionability_description",
"label":"$string:taoyao_PermissionAbility",
"type":"page",
"launchType":"standard",
"metaData":{
"customizeData":[
{
"name":"hwc-theme",
"value":"androidhwext:style/Theme.Emui.Translucent.NoTitleBar"
}
]
}
}

僅僅有上面的步驟好不夠，需要在 Ability 或者 AbilitySlice 里面將窗口設(shè)置成透明。

如下代碼：

getWindow().setTransparent(true);

經(jīng)過上面兩步，也就是將 Ability 的主題和窗口都設(shè)置成透明，這樣就能將 Ability 變成透明的了，同時(shí)也不會(huì)發(fā)生頁面跳轉(zhuǎn)。

⑥判斷用戶是否授予權(quán)限

判斷用戶是否授予權(quán)限，可以使用標(biāo)準(zhǔn)的方式來判斷。也就是通過 grantResult 來判斷用戶是否授予權(quán)限。

@Override
publicbooleanhasPermission(int[]grantResults,String...permissions){
if(grantResults==null||grantResults.length<=?0){
returnfalse;
}
for(intgrantResult:grantResults){
if(grantResult==IBundleManager.PERMISSION_DENIED){
returnfalse;
}
}
returntrue;
}

其實(shí)還有另外的方式來判斷用戶是否授予權(quán)限。也就是不管用戶是否授權(quán)，直接訪問相關(guān)業(yè)務(wù)。

比如，申請(qǐng)錄音權(quán)限，當(dāng)系統(tǒng)回調(diào) onRequestPermissionsFromUserResult 方法時(shí)，直接去錄音，如果發(fā)生異常，捕獲異常說明沒有權(quán)限。

如下代碼：

/**
*通過直接錄音的方式來判斷是否有錄音權(quán)限
*
*@paramcontext
*@return
*@throwsThrowable
*/
@Override
publicbooleantest(Contextcontext)throwsThrowable{
AudioStreamInfoaudioStreamInfo=newAudioStreamInfo.Builder().encodingFormat(
AudioStreamInfo.EncodingFormat.ENCODING_PCM_16BIT)
.channelMask(AudioStreamInfo.ChannelMask.CHANNEL_IN_STEREO)
.sampleRate(AUDIO_SAMPLE_RATE)
.build();
AudioCapturerInfoaudioCapturerInfo=newAudioCapturerInfo.Builder().audioStreamInfo(audioStreamInfo).build();
try{
AudioCapturercapturer=newAudioCapturer(audioCapturerInfo);
//錄音
capturer.start();
newTimer().schedule(newTimerTask(){
@Override
publicvoidrun(){
capturer.stop();
}
},AUDIO_RECORDING_TIME);
//沒有發(fā)生異常，有權(quán)限
returntrue;
}catch(Exceptione){
//發(fā)生異常，無權(quán)限
returnfalse;
}
}

桃夭在判斷用戶是否授權(quán)時(shí)，上面的兩種方式都使用了。至此，桃夭框架的原理基本上講完。有興趣的同學(xué)可以去看看源碼。

想要看懂源碼，需要熟悉申請(qǐng)權(quán)限的一般步驟，桃夭其實(shí)就對(duì)這些步驟進(jìn)行封裝。另外還需熟悉面向接口編程、熟悉策略模式等常見設(shè)計(jì)模式。