0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

一款好用的鸿蒙系统上的权限请求框架

OpenHarmony技术社区 来源:HarmonyOS技术社区 作者:HarmonyOS技术社区 2021-12-03 10:10 次阅读

桃夭是鸿蒙系统上的一款权限请求框架,对请求权限的代码进行高度封装,极大的简化了申请权限的代码逻辑,同时支持在 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;
}
}

桃夭在判断用户是否授权时,上面的两种方式都使用了。至此,桃夭框架的原理基本上讲完。有兴趣的同学可以去看看源码。

要看懂源码,需要熟悉申请权限的一般步骤,桃夭其实就对这些步骤进行封装。另外还需熟悉面向接口编程、熟悉策略模式等常见设计模式。
编辑:jq
声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 代码
    +关注

    关注

    30

    文章

    4847

    浏览量

    69308
  • 权限
    +关注

    关注

    0

    文章

    13

    浏览量

    7302
  • 鸿蒙系统
    +关注

    关注

    183

    文章

    2638

    浏览量

    66884

原文标题:一款好用的鸿蒙权限请求框架!

文章出处:【微信号:gh_834c4b3d87fe,微信公众号:OpenHarmony技术社区】欢迎添加关注!文章转载请注明出处。

收藏 人收藏

    相关推荐

    求推荐一款入门级risc-v开发板

    求推荐一款入门级risc-v开发板: 便宜好用,不超过100元。 支持wifi、蓝牙。 功耗2.5W以内。 支持Linux系统。 谢谢哦。
    发表于 09-29 09:03

    瑞芯微RK3568鸿蒙开发板OpenHarmony系统修改cfg文件权限方法

    本文适用于OpenHarmony开源鸿蒙系统修改cfg文件权限方法,深圳触觉智能研发的RK3566、RK3568、RK3588等开发板、主板等产品均适用此教程
    的头像 发表于 09-11 13:26 1186次阅读
    瑞芯微RK3568<b class='flag-5'>鸿蒙</b>开发板OpenHarmony<b class='flag-5'>系统</b>修改cfg文件<b class='flag-5'>权限</b>方法

    鸿蒙开发Ability Kit程序框架服务:应用权限管控概述 程序访问控制

    系统提供了种允许应用访问系统资源(如:通讯录等)和系统能力(如:访问摄像头、麦克风等)的通用权限访问方式,来保护
    的头像 发表于 07-01 10:21 579次阅读
    <b class='flag-5'>鸿蒙</b>开发Ability Kit程序<b class='flag-5'>框架</b>服务:应用<b class='flag-5'>权限</b>管控概述 程序访问控制

    鸿蒙开发Ability Kit程序框架服务:选择申请权限的方式

    应用在访问数据或者执行操作时,需要评估该行为是否需要应用具备相关的权限。如果确认需要目标权限,则需要在应用安装包中申请目标权限
    的头像 发表于 07-01 09:50 495次阅读
    <b class='flag-5'>鸿蒙</b>开发Ability Kit程序<b class='flag-5'>框架</b>服务:选择申请<b class='flag-5'>权限</b>的方式

    鸿蒙开发Ability Kit程序框架服务:声明权限

    应用在申请权限时,需要在项目的配置文件中,逐个声明需要的权限,否则应用将无法获取授权。
    的头像 发表于 07-01 09:22 426次阅读
    <b class='flag-5'>鸿蒙</b>开发Ability Kit程序<b class='flag-5'>框架</b>服务:声明<b class='flag-5'>权限</b>

    鸿蒙开发Ability Kit程序框架服务:向用户申请授权

    当应用需要访问用户的隐私信息或使用系统能力时,例如获取位置信息、访问日历、使用相机拍摄照片或录制视频等,应该向用户请求授权,这部分权限是user_grant权限
    的头像 发表于 07-01 09:18 685次阅读
    <b class='flag-5'>鸿蒙</b>开发Ability Kit程序<b class='flag-5'>框架</b>服务:向用户申请授权

    鸿蒙开发组件:DataAbility权限控制

    DataAbility提供数据服务,并不是所有的Ability都有权限读写它,DataAbility有权限控制机制来保证数据安全。分为静态权限控制和动态
    的头像 发表于 06-21 10:30 409次阅读
    <b class='flag-5'>鸿蒙</b>开发组件:DataAbility<b class='flag-5'>权限</b>控制

    鸿蒙跨平台框架:【ArkUi-X】创建工程

    鸿蒙推出了鸿ArkUi-X 框架所以就写个文章分享
    的头像 发表于 05-13 17:48 1119次阅读
    <b class='flag-5'>鸿蒙</b>跨平台<b class='flag-5'>框架</b>:【ArkUi-X】创建工程

    鸿蒙开发接口Ability框架:【 (Context模块)】

    Context模块提供了ability或application的上下文的能力,包括允许访问特定于应用程序的资源、请求和验证权限等。
    的头像 发表于 05-13 16:04 811次阅读
    <b class='flag-5'>鸿蒙</b>开发接口Ability<b class='flag-5'>框架</b>:【 (Context模块)】

    鸿蒙原生应用元服务开发-Web管理位置权限

    ohos.permission.LOCATION权限。 在下面的示例中,用户点击前端页面\"获取位置\"按钮,Web组件通过弹窗的形式通知应用侧位置权限请求消息,示例代码如下
    发表于 04-28 16:57

    鸿蒙原生应用元服务-访问控制(权限)开发应用权限列表

    ohos.permission.ACCESS_NOTIFICATION_POLICY 在本设备允许应用访问通知策略。 权限级别 :normal 授权方式 :system_grant ACL使能 :FALSE
    发表于 04-23 14:33

    鸿蒙原生应用元服务-访问控制(权限)开发等级和类型

    的接口,系统弹框由用户授权,用户结合应用运行场景的上下文,识别出应用申请相应敏感权限的合理性,从而做出正确的选择。 即使用户向应用授予过请求权限,应用在调用受此
    发表于 04-17 15:29

    鸿蒙OS开发实例:【HarmonyHttpClient】网络框架

    鸿蒙上使用的Http网络框架,里面包含纯Java实现的HttpNet,类似okhttp使用,支持同步和异步两种请求方式;还有鸿蒙版retrofit,和Android版Retrofit相
    的头像 发表于 04-12 16:58 934次阅读
    <b class='flag-5'>鸿蒙</b>OS开发实例:【HarmonyHttpClient】网络<b class='flag-5'>框架</b>

    鸿蒙系统三防平板怎么样

    鸿蒙系统三防平板是一款功能强大、性能卓越的平板电脑,其独特的三防设计使其成为各种恶劣环境下的理想选择。无论是户外探险、工地作业还是军事应用,鸿蒙系统
    发表于 04-12 14:26

    鸿蒙OS开发实例:【窥探网络请求

    HarmonyOS 平台中使用网络请求,需要引入 "@ohos.net.http", 并且需要在 module.json5 文件中申请网络权限, 即 “ohos.permission.INTERNET” 本篇文章将尝试使用 @ohos.net.http 来实现网络
    的头像 发表于 04-01 16:11 893次阅读
    <b class='flag-5'>鸿蒙</b>OS开发实例:【窥探网络<b class='flag-5'>请求</b>】