前言
自从升级到Android M以来,最大的改变就是增加了运行时权限Runtime Permission,6.0以上的系统如果没有做适配,运行了targetSDK=23的App时就会报权限错误;当然如果你还没准备好适配权限,把targetSDK设置成小于23就ok了,不过适配是迟早的。
运行时权限
谷歌官方将权限分为了两类,一个是正常权限(Normal Permissions),这类权限不涉及用户隐私,是不需要用户进行授权的,比如访问网络,手机震等。还有一类是危险权限(Dangerous Permissions),一般是涉及到用户隐私的,需要用户进行授权,比如操作SD卡的写入,相机,录音等。
我们所要关注的就是危险权限,由上图可以看到这些权限被分为不同的权限组(
PermissionGroup),这里需要说明一下,当一个权限组里的任一权限被授权,
这个组里的其他权限也都会被授权,比如:READ_EXTERNAL_STORAGE这个读SD卡的权限被授权了,这时候WRITE_EXTERNAL_STORAGE也同时被授权。
预览
我们要在保证权限适配的同时,保证代码的整洁和可读,最终我们实现的效果是如下
requestCameraPermission(new PermissionHandler() {
@Override
public void onGranted() {
Intent intent = new Intent(); //调用照相机
intent.setAction(MediaStore.ACTION_IMAGE_CAPTURE);
startActivity(intent);
}
@Override
public void onDenied() {
}
});
实践
关于运行时权限的理论知识就不多说了,网上一搜也是一大把,我们这里着重讲如何实践。当你准备做6.0权限适配的时候,你的第一反应会是:"卧槽,项目中要修改的地方太多了,心中无数个草泥马。"这个时候你要淡定,其实一切没有那么复杂
1.打开应用程序设置-权限,比如微信,这里看到的权限就是你将要进行适配的权限,也不会太多

2.分析哪些权限是基础权限
所谓基础权限就是你的App普遍都需要用的,比如位置、存储权限,如果要在项目中适配这两个权限的话,代码肯定会被改得面目全非,所以我们把这两个权限的获取放在启动页去判断。如果基础权限没有授权通过,我们就不让进入App,基础权限都不给还用个毛,这么一来适配的工作就简单多了。
3.上一个使用原生API获取权限的小栗子
这是最原生的使用方法,可以看到权限的获取操作和获取结果不是在同一个地方的,这样的话对原有代码的改动还是比较大的,而且操作过程繁琐,标题不是说"比你想的还要简单"吗?
4.这个时候PermissionsDispatcher就要登场了github
PermissionsDispatcher是一个通过注解在编译期间生成权限检查代码的工具,以最少的改动来让你的App对权限进行适配。
主要有下面5个注解
@RuntimePermissions 标记需要运行时判断的类
@NeedsPermission 标记需要检查权限的方法
@OnShowRationale 授权提示回调
@OnPermissionDenied 授权被拒绝回调
@OnNeverAskAgain 授权不再拒绝不再显示回调
配置
跟ButterKnife和Dagger2一样,配置方法很简单
在项目的build.gradle文件中加上:
buildscript {
dependencies {
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
}
}
在module中的build.gradle加上:
apply plugin: 'android-apt'
dependencies {
compile 'com.github.hotchemi:permissionsdispatcher:2.1.3'
apt 'com.github.hotchemi:permissionsdispatcher-processor:2.1.3'
}
使用方法
@RuntimePermissions
public class PermissionsDispatcherActivity extends AppCompatActivity implements
View.OnClickListener {
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_normal);
setTitle("PermissionsDispatcher");
findViewById(R.id.btn_camera).setOnClickListener(this);
findViewById(R.id.btn_call).setOnClickListener(this);
}
@Override
public void onClick(View v) {
switch (v.getId()) {
case R.id.btn_call:
PermissionsDispatcherActivityPermissionsDispatcher.
startCallWithCheck(this);
break;
case R.id.btn_camera:
PermissionsDispatcherActivityPermissionsDispatcher.
startCameraWithCheck(this);
break;
}
}
@NeedsPermission(Manifest.permission.CAMERA)
void startCamera() {
Intent intent = new Intent(); //调用照相机
intent.setAction(MediaStore.ACTION_IMAGE_CAPTURE);
startActivity(intent);
}
@NeedsPermission(Manifest.permission.CALL_PHONE)
void startCall(){
Intent intent = new Intent(Intent.ACTION_CALL);
Uri data = Uri.parse("tel:10086");
intent.setData(data);
startActivity(intent);
}
}
1.首先@RuntimePermissions注解需要进行权限判断的类
2.将需要权限的操作定义在一个方法里,并用 @NeedsPermission(Manifest.permission.CAMERA)表明需要的权限(可以是多个)
3.Make编译一下,就会生成【当前类名+PermissionsDispatcher】的类,在原本调用的地方调用@NeedsPermission标记的方法,这时候你会发现会对应生成【方法名+WithCheck】的方法
4.如果你需要监听拒绝后的操作,则使用@OnPermissionDenied,使用方法一样。
原理
PermissionsDispatcher在编译期间,对需要权限判断的方法前后进行修饰,增加权限检查、获取逻辑,我们打开生成的代码看看便知道了,这里边并没有什么高深的东西。
封装
从上面的使用方法来看,增加一个权限判断需要定义一个方法,如果需要监听拒绝,则还要定义对应的方法,当需要获取不同权限的时候代码就多了。这时,我们就可以把权限代码抽取到Activity父类中,这里叫BasePermissionActivity, 代码如下.
/**
* 权限管理
* Created by Laiyimin on 2016/8/16.
*/
@RuntimePermissions
public abstract class BasePermissionActivity extends AppCompatActivity {
/**
* 权限回调接口
*/
public abstract class PermissionHandler {
/**
* 权限通过
*/
public abstract void onGranted();
/**
* 权限拒绝
*/
public void onDenied() {
}
}
private PermissionHandler mHandler;
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions,
int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
BasePermissionActivityPermissionsDispatcher.onRequestPermissionsResult(this,
requestCode, grantResults);
}
//-----------------------------------------------------------
/**
* 请求相机权限
*
* @param permissionHandler
*/
protected void requestCameraPermission(PermissionHandler permissionHandler) {
this.mHandler = permissionHandler;
BasePermissionActivityPermissionsDispatcher.handleCameraPermissionWithCheck
(this);
}
@NeedsPermission(Manifest.permission.CAMERA)
void handleCameraPermission() {
if (mHandler != null)
mHandler.onGranted();
}
@OnPermissionDenied(Manifest.permission.CAMERA)
void deniedCameraPermission() {
if (mHandler != null)
mHandler.onDenied();
}
@OnNeverAskAgain(Manifest.permission.CAMERA)
void OnCameraNeverAskAgain() {
showDialog("[相机]");
}
//-----------------------------------------------------------
/**
* 请求电话权限
*
* @param permissionHandler
*/
protected void requestCallPermission(PermissionHandler permissionHandler) {
this.mHandler = permissionHandler;
BasePermissionActivityPermissionsDispatcher.
handleCallPermissionWithCheck(this);
}
@NeedsPermission(Manifest.permission.CALL_PHONE)
void handleCallPermission() {
if (mHandler != null)
mHandler.onGranted();
}
@OnPermissionDenied(Manifest.permission.CALL_PHONE)
void deniedCallPermission() {
if (mHandler != null)
mHandler.onDenied();
}
@OnNeverAskAgain(Manifest.permission.CALL_PHONE)
void OnCallNeverAskAgain() {
showDialog("[电话]");
}
public void showDialog(String permission) {
new AlertDialog.Builder(this)
.setTitle("权限申请")
.setMessage("在设置-应用-xxx-权限中开启" +
permission + "权限,以正常使用荟医功能")
.setPositiveButton("去开启", new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
Intent intent = new Intent(Settings.
ACTION_APPLICATION_DETAILS_SETTINGS);
Uri uri = Uri.fromParts("package",
getPackageName(), null);
intent.setData(uri);
startActivity(intent);
dialog.dismiss();
}
})
.setNegativeButton("取消", new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
if (mHandler != null) mHandler.onDenied();
dialog.dismiss();
}
})
.setCancelable(false)
.show();
}
}
这里定义了一个PermissionHandler回调接口,同时mHandler保存了当前权限的回调操作(因为同一时间只能有一次权限请求),
protected void requestCameraPermission(PermissionHandler permissionHandler) {
this.mHandler = permissionHandler;
BasePermissionActivityPermissionsDispatcher.
handleCameraPermissionWithCheck(this);
}
@NeedsPermission(Manifest.permission.CAMERA)
void handleCameraPermission() {
if (mHandler != null)
mHandler.onGranted();
}
这里定义好各种权限请求的方法供子类调用,例requestCameraPermission,在它里边调用了权限判断方法,逻辑很简单,大家看看代码就明白了。最后在子类中只要调用这个方法就行了。
requestCameraPermission(new PermissionHandler() {
@Override
public void onGranted() {
Intent intent = new Intent(); //调用照相机
intent.setAction(MediaStore.ACTION_IMAGE_CAPTURE);
startActivity(intent);
}
@Override
public void onDenied() {
}
});
后续
在App运行过程中,用户可能手动去关闭权限,如果这个时候正在使用着权限,应用就会挂掉,我们的处理就是让App自动重启,让其在引导页重新获取权限,保证软件后续正常运行。附带一个CrashHandler类实现了异常重启,在项目代码中可以找到。
GitHub地址 https://github.com/a5533348/XPermission
关于Java和Android大牛频道
Java和Android大牛频道是一个数万人关注的探讨Java和Android开发的公众号,分享和原创最有价值的干货文章,让你成为这方面的大牛!
我们探讨android和Java开发最前沿的技术:android性能优化 ,插件化,跨平台,动态化,加固和反破解等,也讨论设计模式/软件架构等。由一群来自BAT的工程师组成的团队。
关注即送红包,回复:“百度” 、“阿里”、“腾讯” 有惊喜!!!关注后可用入微信群。群里都是来自百度阿里腾讯的大牛。
欢迎关注我们,一起讨论技术,扫描和长按下方的二维码可快速关注我们。或搜索微信公众号:JANiubility。
公众号:JANiubility
如想加群讨论学习,请关注微信公众号点击右下角的“加群学习”菜单入群。