Android6.0权限适配

前言

自从升级到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

如想加群讨论学习，请关注微信公众号点击右下角的“加群学习”菜单入群。