桃夭是鴻蒙系統上的一款權限請求框架,對請求權限的代碼進行高度封裝,極大的簡化了申請權限的代碼邏輯,同時支持在 Ability、FractionAbility、AbilitySlice、Fractiion 里面申請權限。
建議大家把源碼下載下來看看:
https://gitee.com/zhongte/TaoYao
申請權限
申請權限的一般步驟如下:
-
判斷是否有權限,如果有權限,直接進行下一步。
-
如果沒有權限,可以彈窗告知用戶申請權限的原因。
-
彈窗告知用戶后,如果用戶同意申請權限,則判斷用戶是否點擊了不再提醒。
-
如果用戶沒有點擊不再提醒,則開始申請權限。
-
如果用戶點擊了不再提醒,則彈窗告知用戶去設置頁面開啟權限,用戶點擊彈窗后,跳轉到設置頁面。
-
重寫 onRequestPermissionsFromUserResult 方法,判斷用戶是否授予權限。
每次申請權限的時候,都需要經過以上幾個步驟,當申請的權限越來越多,大量的重復代碼就出現了。
為了減少重復代碼,我封裝了一個權限請求框架,權限請求框架取名為桃夭。
桃夭的使用方式
如下代碼,先添加依賴,然后你只需要告知權限請求框架你需要什么權限,權限請求框架就會告知你權限申請成功還是失敗。你不需要手動判斷是否有權限,不需要彈窗告知用戶申請權限的原因,不需要判斷用戶是否點擊了不再提醒,不需要跳轉設置頁面讓用戶開啟權限,不需要重寫 onRequestPermissionsFromUserResult 方法。
框架把這些代碼邏輯都給做了,你只需要關注權限申請成功還是失敗。申請權限變得如此之簡單。
添加依賴:
api'io.gitee.zhongte1.0.1'
申請權限:
//申請多設備協同權限
EasyPermission.requestPermission(this,EasyPermission.DISTRIBUTED_DATASYNC,newPermissionAction(){
@Override
publicvoidonGranted(Listpermissions) {
//權限申請成功
}
@Override
publicvoidonDenied(Listpermissions) {
//權限申請失敗
}
},SystemPermission.DISTRIBUTED_DATASYNC);
申請權限的時候可能會涉及到兩個彈窗,一個彈窗是用來告知用戶申請權限的原因,另一個彈窗是用來告知用戶去設置頁面開啟權限。
這兩個彈窗在不同的應用里面可能長得不一樣,所以這兩個彈窗并沒有被封裝到桃夭框架里面,而是需要使用者根據你的彈窗樣式對桃夭進行二次封裝。
我在源碼里面對桃夭框架進行了二次封裝,大家可以把源碼下載下來,參考下我是如何對桃夭框架進行二次封裝的。二次封裝完成后,就可以愉快的使用上面的代碼申請權限了。
實現原理
①檢測申請的權限是否在配置文件中聲明
申請的權限必須在配置文件中聲明,否則桃夭會直接拋異常。如何檢測申請的權限是否在配置文件中聲明。
如下代碼,獲取 bundleManager 對象,通過 bundleManager 對象獲取應用信息,之后就可以獲取應用在配置文件中聲明的權限了。
/**
*獲取在配置文件中聲明的權限
*
*@paramcontext上下文
*@return在配置文件中聲明的權限
*/
privateListgetConfigPermissions(Contextcontext){
//獲取bundleManager對象
IBundleManagerbundleManager=context.getBundleManager();
StringbundleName=context.getBundleName();
try{
//獲取應用信息
BundleInfobundleInfo=bundleManager.getBundleInfo(bundleName,IBundleManager.GET_BUNDLE_WITH_REQUESTED_PERMISSION);
//獲取應用在配置文件中聲明的權限
ListreqPermissionDetails=bundleInfo.reqPermissions;
if(reqPermissionDetails==null||reqPermissionDetails.isEmpty()){
thrownewIllegalStateException("請在配置文件中聲明要申請的權限");
}
returnreqPermissionDetails;
}catch(RemoteExceptione){
e.printStackTrace();
}
returnnewArrayList<>();
}
獲取到在配置文件中聲明的權限后,就可以判斷申請的權限是否在配置文件中了。
/**
*檢查申請的權限是否在配置文件中聲明
*
*@parampermissions要申請的權限
*/
privatevoidcheckPermissions(String...permissions){
if(permissions==null||permissions.length==0){
thrownewIllegalArgumentException("請至少申請一個權限");
}
//獲取在配置文件中聲明的權限
mReqPermissions=getConfigPermissions(mOrigin.getContext());
if(mReqPermissions.isEmpty()){
thrownewIllegalStateException("請在配置文件中聲明要申請的權限");
}
for(Stringtarget:permissions){
if(!mReqPermissions.contains(target)){
//沒有在配置中聲明要申請的權限,直接拋異常
thrownewIllegalStateException(String.format("%1$s權限沒有配置文件中聲明",target));
}
}
}
②判斷是否有權限
檢測完權限是否在配置中聲明后,就可以判斷是否有權限了。這里就是通過上下文對象的 verifySelfPermission 方法來判斷是否有權限,如果沒有權限,可以彈窗告知用戶申請的原因。
/**
*是否有權限
*
*@paramcontext
*@parampermissions
*@return
*/
@Override
publicbooleanhasPermission(Contextcontext,Listpermissions) {
for(Stringpermission:permissions){
intresult=context.verifySelfPermission(permission);
if(result==IBundleManager.PERMISSION_DENIED){
//沒有權限
returnfalse;
}
}
returntrue;
}
③判斷用戶是否點擊了不再提醒
通過上下文對象的 canRequestPermission 方法來判斷用戶是否點擊了不再提醒。
/**
*用戶是否點擊了不在提醒
*
*@parampermission權限
*@return
*/
@Override
publicbooleancanRequestPermission(Stringpermission){
returnmContext.canRequestPermission(permission);
}
④跳轉到設置頁面
如果用戶點擊了不再提醒,則可以跳轉到設置頁面讓用戶開啟權限。
/**
*跳轉到設置頁面
*/
@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();
}
}
⑤啟動透明的 Ability 申請權限
如果沒有權限,用戶頁面沒有點擊不再提醒,那就可以申請權限了。為了不讓調用者重寫 onRequestPermissionsFromUserResult 方法,桃夭內部啟動了一個 Ability。
如下代碼:
/**
*開啟一個透明的Ability來申請權限,這樣外界就不需要重寫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);
//請求權限
requestPermissionsFromUser(permissions.toArray(newString[0]),REQUEST_CODE);
}
@Override
publicvoidonRequestPermissionsFromUserResult(intrequestCode,String[]permissions,int[]grantResults){
super.onRequestPermissionsFromUserResult(requestCode,permissions,grantResults);
//權限的回調方法
Postman.send(permissions,grantResults);
terminateAbility();
}
@Override
protectedvoidonAbilityResult(intrequestCode,intresultCode,IntentresultData){
super.onAbilityResult(requestCode,resultCode,resultData);
}
}
直接啟動一個 Ability 會發生頁面跳轉,為了不讓頁面發生跳轉,這里啟動了一個透明的 Ability。
如何將 Ability 設置透明,如下代碼。在 abilities 節點添加 metaData,這里最關鍵的是 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 里面將窗口設置成透明。
如下代碼:
getWindow().setTransparent(true);
經過上面兩步,也就是將 Ability 的主題和窗口都設置成透明,這樣就能將 Ability 變成透明的了,同時也不會發生頁面跳轉。
⑥判斷用戶是否授予權限
判斷用戶是否授予權限,可以使用標準的方式來判斷。也就是通過 grantResult 來判斷用戶是否授予權限。
@Override
publicbooleanhasPermission(int[]grantResults,String...permissions){
if(grantResults==null||grantResults.length<=?0){
returnfalse;
}
for(intgrantResult:grantResults){
if(grantResult==IBundleManager.PERMISSION_DENIED){
returnfalse;
}
}
returntrue;
}
其實還有另外的方式來判斷用戶是否授予權限。也就是不管用戶是否授權,直接訪問相關業務。
比如,申請錄音權限,當系統回調 onRequestPermissionsFromUserResult 方法時,直接去錄音,如果發生異常,捕獲異常說明沒有權限。
如下代碼:
/**
*通過直接錄音的方式來判斷是否有錄音權限
*
*@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);
//沒有發生異常,有權限
returntrue;
}catch(Exceptione){
//發生異常,無權限
returnfalse;
}
}
桃夭在判斷用戶是否授權時,上面的兩種方式都使用了。至此,桃夭框架的原理基本上講完。有興趣的同學可以去看看源碼。
想要看懂源碼,需要熟悉申請權限的一般步驟,桃夭其實就對這些步驟進行封裝。另外還需熟悉面向接口編程、熟悉策略模式等常見設計模式。
-
代碼
+關注
關注
30文章
4750瀏覽量
68357 -
權限
+關注
關注
0文章
13瀏覽量
7258 -
鴻蒙系統
+關注
關注
183文章
2634瀏覽量
66220
原文標題:一款好用的鴻蒙權限請求框架!
文章出處:【微信號:gh_834c4b3d87fe,微信公眾號:OpenHarmony技術社區】歡迎添加關注!文章轉載請注明出處。
發布評論請先 登錄
相關推薦
評論