PermissionsDispatcher（Android权限管理框架）

PermissionsDispatcher框架

Android的危险权限列表，因此开发中为了适应6.0系统，我们需要进行再执行代码时需要对应权限之前，去向用户请求我们需要操作的对应权限。
项目的GitHub地址：https://github.com/hotchemi/PermissionsDispatcher

---

项目的集成：

For Android Gradle Plugin >= 2.2 users (Android Studio2.2以上包含2.2的用户这样配置)

To add it to your project, include the following in your app module build.gradle file:

${latest.version} is Download （2017年3月9日18:13:31 的最新版为：2.3.1）

dependencies {
  compile 'com.github.hotchemi:permissionsdispatcher:${latest.version}'
  annotationProcessor 'com.github.hotchemi:permissionsdispatcher-processor:${latest.version}'
}

For Android Gradle Plugin < 2.2 users(Android Studio2.2以下上的用户这样配置)

To add it to your project, include the following in your project build.gradle file:

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

Snapshots of the development version are available in JFrog’s snapshots repository. Add the repo below to download SNAPSHOT releases.

repositories {
  jcenter()
  maven { url 'http://oss.jfrog.org/artifactory/oss-snapshot-local/' }
}

And on your app module build.gradle:

${latest.version} is Download

apply plugin: 'android-apt'

dependencies {
  compile 'com.github.hotchemi:permissionsdispatcher:${latest.version}'
  apt 'com.github.hotchemi:permissionsdispatcher-processor:${latest.version}'
}

---

---

框架的使用方法

使用步骤

步骤几	步骤名称	功能
第一步	@RuntimePermissions	需要在Activity的Class声明此注解，来处理我们的权限
第二步	@NeedsPermission	注释请求的权限后面跟着权限获取后执行的方法
第三步	@OnShowRationale	一般用于展示用户点击取消后向用户说明原因，在positiveButton上一般帮一个监听器执行request.proceed()方法，在取消按钮上帮一个监听器执行request.cancel()方法
第四步	@OnPermissionDenied	用户拒绝后执行的方法
第五步	@OnNeverAskAgain	用户点击不再询问后执行的方法
第六步	MainActivityPermissionsDispatcher.showXXXXWithCheck(MainActivity.this);	此方法用于在适当时候获取权限，具体内容可以在生成的辅助类MainActivityPermissionsDispatcher中间查看
第七部		调用辅助类处理放回的结果

---

示例代码

@RuntimePermissions
public class MainActivity extends AppCompatActivity {
    private Button callPhone;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        callPhone = (Button) findViewById(R.id.show_phone);
        callPhone.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
               MainActivityPermissionsDispatcher.showToastWithCheck(MainActivity.this);
            }
        });

    }

    @NeedsPermission(Manifest.permission.CALL_PHONE)//在需要获取权限的地方注释
    void showToast() {

        Toast.makeText(this, "获取存储卡权限", Toast.LENGTH_SHORT).show();

    }
    @OnShowRationale(Manifest.permission.CALL_PHONE)//提示用户为什么需要此权限
    void showWhy(final PermissionRequest request) {
        new AlertDialog.Builder(this)
                .setMessage("权限测试")
                .setPositiveButton("知道了", new DialogInterface.OnClickListener() {
                    @Override
                    public void onClick(DialogInterface dialog, int which) {
                       request.proceed();//再次执行请求
                    }
                })
                .show();
    }
    @OnPermissionDenied(Manifest.permission.CALL_PHONE)//一旦用户拒绝了
    void denied() {
        Toast.makeText(this, "哥哥给个权限吧", Toast.LENGTH_SHORT).show();
    }
    @OnNeverAskAgain(Manifest.permission.CALL_PHONE)//用户选择的不再询问
    void notAsk() {
        Toast.makeText(this, "很开心，以后不打扰你了", Toast.LENGTH_SHORT).show();
    }

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

        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        MainActivityPermissionsDispatcher.onRequestPermissionsResult(this, requestCode, grantResults);
    }
}