一个好用的动态权限请求工具

2024年4月15日 互联网

一个好用的动态权限请求工具

    • 一个好用的动态权限请求工具
          • 优点
          • 使用方法
          • 请求示例
          • PermissionUtils类中API说明
          • SimpleCallback接口说明
          • FullCallback接口说明
          • 参考文档

一个好用的动态权限请求工具

工具类参考自GitHub上开源工程Blankj的AndroidUtilCode中的PermissionUtils 和tbruyelle的RxPermissions

项目地址：https://github.com/bluetomcat/PermissionsUtils

优点
  • 采用敏感权限组和AndroidManifest中声明的权限管理动态权限申请，可以省略查找哪些敏感需要动态申请的过程。
  • 采用内置Fragment管理请求回调，使用时无须手动重写public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults)方法。
  • 采用builder设计模式，链式编程
使用方法

项目的build.gradle配置

allprojects {repositories {...maven { url 'https://jitpack.io' }}}

module的build.gradle配置

dependencies {implementation 'com.github.bluetomcat:PermissionsUtils:1.0'}
请求示例

AndroidManifest.xml文件：

<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_CALENDAR"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>//测试manifest文件中多余动态权限

动态权限请求的Activity/Fragment中：

val request = PermissionUtils.builder().permission(Manifest.permission_group.STORAGE,Manifest.permission_group.CALENDAR,Manifest.permission_group.PHONE,Manifest.permission_group.SENSORS//测试申请时多余动态权限).setResultListener(object : FullCallback {override fun onDenied(permissionsDeniedForever: MutableList<String>?,permissionsDenied: MutableList<String>?) {if (permissionsDeniedForever != null) {for (permission in permissionsDeniedForever) {Log.e(TAG, "DeniedForever:" + permission)}}if (permissionsDenied != null) {for (permission in permissionsDenied) {Log.e(TAG, "Denied:" + permission)}}}override fun onFinish() {Log.e(TAG, "onFinish");}override fun onGranted(permissionsGranted: MutableList<String>?) {if (permissionsGranted != null) {for (permission in permissionsGranted) {Log.e(TAG, "Granted:" + permission)}}}}).setRationale(Manifest.permission_group.PHONE)//可省.build(this).request()

实际动态申请的权限（设置的需申请的动态权限组合所含权限集合与AndroidManifest文件中声明的权限集合的交集）：

android.permission.READ_EXTERNAL_STORAGE
android.permission.WRITE_EXTERNAL_STORAGE
android.permission.WRITE_CALENDAR
android.permission.READ_PHONE_STATE
PermissionUtils类中API说明
  • builder() ：静态方法，获取Builder对象
  • permission(@Permission String... permissions)：Builder对象中的方法，设置需要动态请求的敏感权限组（动态申请的权限就是这里设置的权限组中的权限集和AndroidManifest文件中声明的权限集的交集）
  • setResultListener(ResultListener listener)：Builder对象中的方法，设置权限请求结果监听（内置FullCallback和SimpleCallback两个接口回调，详情后面单独说明）
  • setRationale(@Nullable @Permission String... permissions)：Builder对象中的方法，设置需要重复请求的权限组，不常用，可省
  • build(FragmentActivity activity) 和build(Fragment fragment)：Builder对象中的方法，构建PermissionUtils对象，参数为支持包中的FragmentActivity /Fragment
  • isGranted(final String... permissions)：PermissionUtils对象中的方法，判断权限组中所需动态申请的权限是否全部已通过，通过内置的Fragment对象判断
  • isGranted(final String permission)：PermissionUtils对象中的方法，判断动态权限是否申请通过，通过内置的Fragment对象判断
  • request()：PermissionUtils对象中的方法，开始请求动态权限
  • onDestroy()：PermissionUtils对象中的方法，绑定了build中FragmentActivity /Fragment的生命周期，自动在其onDestroy()方法中调用
SimpleCallback接口说明

动态权限请求结果回调，其API仅在权限请求全部结束后调用，具体说明如下：

  • onDenied()：申请的权限存在被拒绝的权限时调用
  • onGranted()：申请的权限全部通过时调用
FullCallback接口说明

动态权限请求结果回调，其API说明如下：

  • onGranted(List<String> permissionsGranted)：每次请求循环结束后，申请的权限存在被通过的权限时调用，参数是通过的权限集合
  • onDenied(List<String> permissionsDeniedForever, List<String> permissionsDenied)：每次请求循环结束后，申请的权限存在被拒绝的权限时调用，参数是被永久拒绝的权限集合和被拒绝的权限集合
  • onFinish()：所有请求结束后调用
参考文档

PermissionUtils.Java：https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/lib/src/main/java/com/blankj/utilcode/util/PermissionUtils.java
RxPermissions:
https://github.com/tbruyelle/RxPermissions

注：能力有限，如有不足欢迎大神指教，万分感谢！！！

最新文章