如何使用鴻蒙系統(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)行下一步。

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

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

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

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

• 重寫 onRequestPermissionsFromUserResult 方法，判斷用戶是否授予權(quá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);

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

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

如下代碼，獲取 bundleManager 對(duì)象，通過(guò) 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)){
//沒(méi)有在配置中聲明要申請(qǐng)的權(quán)限，直接拋異常
thrownewIllegalStateException(String.format("%1$s權(quán)限沒(méi)有配置文件中聲明",target));
}
}
}

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

檢測(cè)完權(quán)限是否在配置中聲明后，就可以判斷是否有權(quán)限了。這里就是通過(guò)上下文對(duì)象的 verifySelfPermission 方法來(lái)判斷是否有權(quán)限，如果沒(méi)有權(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){
//沒(méi)有權(quán)限
returnfalse;
}
}
returntrue;
}

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

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

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

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

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

/**
*跳轉(zhuǎn)到設(shè)置頁(yè)面
*/
@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)限

如下代碼：

/**
*開啟一個(gè)透明的Ability來(lái)申請(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);
}
}

如何將 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"
}
]
}
}

如下代碼：

getWindow().setTransparent(true);

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

判斷用戶是否授予權(quán)限，可以使用標(biāo)準(zhǔn)的方式來(lái)判斷。也就是通過(guò) grantResult 來(lái)判斷用戶是否授予權(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;
}

如下代碼：

/**
*通過(guò)直接錄音的方式來(lái)判斷是否有錄音權(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);
//沒(méi)有發(fā)生異常，有權(quán)限
returntrue;
}catch(Exceptione){
//發(fā)生異常，無(wú)權(quán)限
returnfalse;
}
}