PermissionsDispatcher使用详解

PermissionsDispatcher是一个基于注解、帮助开发者简单处理Android 6.0系统中的运行时权限的开源库。避免了开发者编写大量繁琐的样板代码。

开源地址：https://github.com/hotchemi/PermissionsDispatcher

1. 添加依赖：
工程项目的：build.gradle

buildscript {
  dependencies {
    classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
  }

app模块的build.gradle

apply plugin: 'android-apt'
//将最新的版本改为当前版本号，例如2.3.1(报错就填写固定的版本号)
dependencies {
  compile 'com.github.hotchemi:permissionsdispatcher:${latest.version}'
  apt 'com.github.hotchemi:permissionsdispatcher-processor:${latest.version}'
}

并将 targetSdkVersion设为23，即： targetSdkVersion 23

2、在Activity或Fragment中使用

注解列表：

Annotation	Required	Description
@RuntimePermissions	✓	注解在其内部需要使用运行时权限的Activity或Fragment上
@NeedsPermission	✓	注解在需要调用运行时权限的方法上，当用户给予权限时会执行该方法
@OnShowRationale		注解在用于向用户解释为什么需要调用该权限的方法上，只有当第一次请求权限被用户拒绝，下次请求权限之前会调用
@OnPermissionDenied		注解在当用户拒绝了权限请求时需要调用的方法上
@OnNeverAskAgain		注解在当用户选中了授权窗口中的不再询问复选框后并拒绝了权限请求时需要调用的方法，一般可以向用户解释为何申请此权限，并根据实际需求决定是否再次弹出权限请求对话框

注意：被注解的方法不能是私有方法。

只有 @RuntimePermissions和 @NeedsPermission是必须的，其余注解均为可选。当使用了 @RuntimePermissions和 @NeedsPermission之后，需要点击菜单栏中 Build菜单下的 Make Project，或者按快捷键 Ctrl + F9编译整个项目，编译器会在 app\build\intermediates\classes\debug目录下与被注解的Activity同一个包下生成一个辅助类，名称为 被注解的Activity名称+PermissionsDispatcher.class

接下来可以调用辅助类里面的方法完成应用的权限请求了。

在需要调用权限的位置调用辅助类里面的xxxWithCheck方法，xxx是被@NeedsPermission注解的方法名。如：

MainActivityPermissionsDispatcher.showCameraWithCheck(this);

之后，还需要重写该Activity的onRequestPermissionsResult()方法，其方法内调用辅助类的onRequestPermissionsResult()方法，如下：

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull