前言

在Android开发过程中，经常会涉及到Android动态权限的申请，之前我已经介绍并封装了一个权限库，基于那个库的作者已经很久维护的考虑，于是准备学习一个新的权限库，在对比了AndPermission，RxPermission登库后，发现PermissionsDispatcher的start量已经达到9.7k(截至目前)多，于是准备学习这个库了。那么今天就来学习下。

1. 库依赖
2. 库使用条件
3. 注解解释
4. 请求单个权限和多个权限的写法
5. 具体使用流程
6. PermissionsDispatcher插件
7. PermissionsDispatcher官网
8. 效果图和项目结构图

先来波效果图

1.gif

一.库依赖

在你项目的app_moduel对应的build.gradle中添加如下依赖：

dependencies {
   
    //PermissionsDispatcher权限
    implementation "org.permissionsdispatcher:permissionsdispatcher:4.6.0"
    annotationProcessor "org.permissionsdispatcher:permissionsdispatcher-processor:4.6.0"

    //其他代码省略
    //......

}

二.库使用条件

PermissionsDispatcher权限库和很多其他的库一样，也是基于注解的使用。在项目中使用的时候，基于它注解的方法，不能是 private 方法。

三.注解解释

PermissionsDispatcher权限库有很多的注解。

3.1 @RuntimePermissions

此注解用在Activity或Fragment之上，用于处理权限，以给activity添加权限为例：

@RuntimePermissions
public class MainActivity extends AppCompatActivity implements View.OnClickListener {
    //其他代码省略
    //......
}

3.2 @NeedsPermission

此注解注释到用户已经授权的方法上，这个方法用于处理用户允许权限后的操作。
类似下面这样：

    /**申请权限**/
    @NeedsPermission({Manifest.permission.READ_PHONE_STATE})
    void requestPhoneState() {
        LogUtil.i("=====允许授权=====");
        //获取设备号
        //......
    }

3.3 @OnShowRationale

一般注释在dialog上，当用户之前拒绝授权(未勾选不再询问)，这次打开app点击执行需要授权的方法时的处理，而这个dialog用于解释当前操作需要申请什么权限。如：

    /**弹授权框(第一次拒绝后,第二次打开弹出的授权框)**/
    @OnShowRationale({Manifest.permission.READ_PHONE_STATE})
    void showDialog(final PermissionRequest request){
        new AlertDialog.Builder(this)
                .setMessage("是否授权手机权限?")
                .setPositiveButton("确定", new DialogInterface.OnClickListener() {
                    @Override
                    public void onClick(DialogInterface dialog, int which) {
                        request.proceed();
                    }
                })
                .setNegativeButton("取消", new DialogInterface.OnClickListener() {
                    @Override
                    public void onClick(DialogInterface dialog, int which) {
                        request.cancel();
                    }
                })
                .show();
    }

3.4 @OnPermissionDenied

注释在用户拒绝授权的方法上，而这个被注释的方法，用于处理用户拒绝授权后的操作.
用户拒绝授权后的操作，一般是做弹窗提示，或引导用户去设置

    /**拒绝授权**/
    @OnPermissionDenied({Manifest.permission.READ_PHONE_STATE})
    void deniedPermission(){
        LogUtil.i("=====拒绝授权的处理=====");

        //弹框提示：需要授权
        //......
    }

3.5 @OnNeverAskAgain

注释一个方法，如果用户选择让设备“永远不要再问”有关权限时调用该方法
用户勾选过“不再询问”后测处理。一般处理与“拒绝授权”的处理相同。

    /**不再询问**/
    @OnNeverAskAgain({Manifest.permission.READ_PHONE_STATE})
    void neverAskPermission(){
        LogUtil.i("=====不再询问的处理=====");

        //弹框提示：需要授权
        //......
    }

四.请求单个权限和多个权限的写法

以注解 @NeedsPermission 为例，请求单个权限，你可以这样写：