步骤:
1. 添加依赖:
工程项目的:build.gradle
buildscript {
dependencies {
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
}
}
target_sdk_version = 23
app模块的build.gradle
apply plugin: 'android-apt'
//将最新的版本改为当前版本号,例如2.1.3
dependencies {
compile 'com.github.hotchemi:permissionsdispatcher:2.3.1' apt 'com.github.hotchemi:permissionsdispatcher-processor:2.3.1'
}
使用
假设我们想获取危险权限例如使用拨号器打电话;Manifest.permission.CALL_PHONE
以下步骤:
1. 使用@RuntimePermissions
注释此活动或碎片
2. @NeedsPermission
注释请求的权限后面跟着权限获取后执行的方法@NeedsPermission(Manifest.permission.CALL_PHONE)
3. @OnShowRationale
一般用于展示用户点击取消后向用户说明原因,在positiveButton上一般帮一个监听器执行request.proceed()方法,在取消按钮上帮一个监听器执行request.cancel()方法
4. @OnPermissionDenied :用户拒绝后执行的方法
5. @OnNeverAskAgain :用户点击不再询问后执行的方法
6. MainActivityPermissionsDispatcher.showXXXXWithCheck(MainActivity.this);
此方法用于在适当时候获取权限,具体内容可以在生成的辅助类MainActivityPermissionsDispatcher中间查看
7.最后要调用辅助类处理放回的结果
@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) {
//要build-> MakeProject才会生成showToastWithCheck方法 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); } }