Android 6.0 运行时权限处理完全解析

一、概述

随着Android 6.0发布以及普及，我们开发者所要应对的主要就是新版本SDK带来的一些变化，首先关注的就是权限机制的变化。对于6.0的几个主要的变化，查看查看官网的这篇文章http://developer./intl/zh-cn/about/versions/marshmallow/android-6.0-changes.html，其中当然包含Runtime Permissions。

ok，本篇文章目的之一就是对运行时权限处理的一个介绍，以及对目前权限相关的库的一些了解。

当然非常推荐阅读官网权限相关文章：

• Working with System Permissions
• Permissions Best Practices

本文也是在上述文章基础上理解、实验以及封装。

二、运行时权限的变化及特点

对于6.0以下的权限及在安装的时候，根据权限声明产生一个权限列表，用户只有在同意之后才能完成app的安装，造成了我们想要使用某个app，就要默默忍受其一些不必要的权限（比如是个app都要访问通讯录、短信等）。而在6.0以后，我们可以直接安装，当app需要我们授予不恰当的权限的时候，我们可以予以拒绝（比如：单机的象棋对战，请求访问任何权限，我都是不同意的）。当然你也可以在设置界面对每个app的权限进行查看，以及对单个权限进行授权或者解除授权。

新的权限机制更好的保护了用户的隐私，Google将权限分为两类，一类是Normal Permissions，这类权限一般不涉及用户隐私，是不需要用户进行授权的，比如手机震动、访问网络等；另一类是Dangerous Permission，一般是涉及到用户隐私的，需要用户进行授权，比如读取sdcard、访问通讯录等。

Normal Permissions如下

Java代码  

1. ACCESS_LOCATION_EXTRA_COMMANDS  
2. ACCESS_NETWORK_STATE  
3. ACCESS_NOTIFICATION_POLICY  
4. ACCESS_WIFI_STATE  
5. BLUETOOTH  
6. BLUETOOTH_ADMIN  
7. BROADCAST_STICKY  
8. CHANGE_NETWORK_STATE  
9. CHANGE_WIFI_MULTICAST_STATE  
10. CHANGE_WIFI_STATE  
11. DISABLE_KEYGUARD  
12. EXPAND_STATUS_BAR  
13. GET_PACKAGE_SIZE  
14. INSTALL_SHORTCUT  
15. INTERNET  
16. KILL_BACKGROUND_PROCESSES  
17. MODIFY_AUDIO_SETTINGS  
18. NFC  
19. READ_SYNC_SETTINGS  
20. READ_SYNC_STATS  
21. RECEIVE_BOOT_COMPLETED  
22. REORDER_TASKS  
23. REQUEST_INSTALL_PACKAGES  
24. SET_ALARM  
25. SET_TIME_ZONE  
26. SET_WALLPAPER  
27. SET_WALLPAPER_HINTS  
28. TRANSMIT_IR  
29. UNINSTALL_SHORTCUT  
30. USE_FINGERPRINT  
31. VIBRATE  
32. WAKE_LOCK  
33. WRITE_SYNC_SETTINGS  

Dangerous Permissions:

Java代码  

1. group:android.permission-group.CONTACTS  
2.   permission:android.permission.WRITE_CONTACTS  
3.   permission:android.permission.GET_ACCOUNTS  
4.   permission:android.permission.READ_CONTACTS  
5.   
6. group:android.permission-group.PHONE  
7.   permission:android.permission.READ_CALL_LOG  
8.   permission:android.permission.READ_PHONE_STATE  
9.   permission:android.permission.CALL_PHONE  
10.   permission:android.permission.WRITE_CALL_LOG  
11.   permission:android.permission.USE_SIP  
12.   permission:android.permission.PROCESS_OUTGOING_CALLS  
13.   permission:com.android.voicemail.permission.ADD_VOICEMAIL  
14.   
15. group:android.permission-group.CALENDAR  
16.   permission:android.permission.READ_CALENDAR  
17.   permission:android.permission.WRITE_CALENDAR  
18.   
19. group:android.permission-group.CAMERA  
20.   permission:android.permission.CAMERA  
21.   
22. group:android.permission-group.SENSORS  
23.   permission:android.permission.BODY_SENSORS  
24.   
25. group:android.permission-group.LOCATION  
26.   permission:android.permission.ACCESS_FINE_LOCATION  
27.   permission:android.permission.ACCESS_COARSE_LOCATION  
28.   
29. group:android.permission-group.STORAGE  
30.   permission:android.permission.READ_EXTERNAL_STORAGE  
31.   permission:android.permission.WRITE_EXTERNAL_STORAGE  
32.   
33. group:android.permission-group.MICROPHONE  
34.   permission:android.permission.RECORD_AUDIO  
35.   
36. group:android.permission-group.SMS  
37.   permission:android.permission.READ_SMS  
38.   permission:android.permission.RECEIVE_WAP_PUSH  
39.   permission:android.permission.RECEIVE_MMS  
40.   permission:android.permission.RECEIVE_SMS  
41.   permission:android.permission.SEND_SMS  
42.   permission:android.permission.READ_CELL_BROADCASTS  

可以通过adb shell pm list permissions -d -g进行查看。

看到上面的dangerous permissions，会发现一个问题，好像危险权限都是一组一组的，恩，没错，的确是这样的，

那么有个问题：分组对我们的权限机制有什么影响吗？

的确是有影响的，如果app运行在Android 6.x的机器上，对于授权机制是这样的。如果你申请某个危险的权限，假设你的app早已被用户授权了同一组的某个危险权限，那么系统会立即授权，而不需要用户去点击授权。比如你的app对READ_CONTACTS已经授权了，当你的app申请WRITE_CONTACTS时，系统会直接授权通过。此外，对于申请时弹出的dialog上面的文本说明也是对整个权限组的说明，而不是单个权限（ps:这个dialog是不能进行定制的）。

不过需要注意的是，不要对权限组过多的依赖，尽可能对每个危险权限都进行正常流程的申请，因为在后期的版本中这个权限组可能会产生变化。

三、相关API

好在运行时相关的API也比较简单，所以适配起来并不会非常痛苦。

API的讲解就跟着申请权限步骤一起了：

1. 在AndroidManifest文件中添加需要的权限。这个步骤和我们之前的开发并没有什么变化，试图去申请一个没有声明的权限可能会导致程序崩溃。
2. 检查权限

Java代码  

1. if (ContextCompat.checkSelfPermission(thisActivity,  
2.                 Manifest.permission.READ_CONTACTS)  
3.         != PackageManager.PERMISSION_GRANTED) {  
4. }else{  
5.     //  
6. }  

这里涉及到一个API，ContextCompat.checkSelfPermission，主要用于检测某个权限是否已经被授予，方法返回值为PackageManager.PERMISSION_DENIED或者PackageManager.PERMISSION_GRANTED。当返回DENIED就需要进行申请授权了。

3. 申请授权

Java代码  

1. ActivityCompat.requestPermissions(thisActivity,  
2.                 new String[]{Manifest.permission.READ_CONTACTS},  
3.                 MY_PERMISSIONS_REQUEST_READ_CONTACTS);  

该方法是异步的，第一个参数是Context；第二个参数是需要申请的权限的字符串数组；第三个参数为requestCode，主要用于回调的时候检测。可以从方法名requestPermissions以及第二个参数看出，是支持一次性申请多个权限的，系统会通过对话框逐一询问用户是否授权。

4. 处理权限申请回调

Java代码  

1. @Override  
2. public void onRequestPermissionsResult(int requestCode,  
3.         String permissions[], int[] grantResults) {  
4.     switch (requestCode) {  
5.         case MY_PERMISSIONS_REQUEST_READ_CONTACTS: {  
6.             // If request is cancelled, the result arrays are empty.  
7.             if (grantResults.length > 0  
8.                 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {  
9.   
10.                 // permission was granted, yay! Do the  
11.                 // contacts-related task you need to do.  
12.   
13.             } else {  
14.   
15.                 // permission denied, boo! Disable the  
16.                 // functionality that depends on this permission.  
17.             }  
18.             return;  
19.         }  
20.     }  
21. }  

ok，对于权限的申请结果，首先验证requestCode定位到你的申请，然后验证grantResults对应于申请的结果，这里的数组对应于申请时的第二个权限字符串数组。如果你同时申请两个权限，那么grantResults的length就为2，分别记录你两个权限的申请结果。如果申请成功，就可以做你的事情了~

当然，到此我们的权限申请的不走，基本介绍就如上述。不过还有个API值得提一下：

Java代码  

1. // Should we show an explanation?  
2. if (ActivityCompat.shouldShowRequestPermissionRationale(thisActivity,  
3.         Manifest.permission.READ_CONTACTS))   
4.     // Show an expanation to the user *asynchronously* -- don't block  
5.     // this thread waiting for the user's response! After the user  
6.     // sees the explanation, try again to request the permission.  
7.   
8. }  

这个API主要用于给用户一个申请权限的解释，该方法只有在用户在上一次已经拒绝过你的这个权限申请。也就是说，用户已经拒绝一次了，你又弹个授权框，你需要给用户一个解释，为什么要授权，则使用该方法。

那么将上述几个步骤结合到一起就是：

Java代码  

1. // Here, thisActivity is the current activity  
2. if (ContextCompat.checkSelfPermission(thisActivity,  
3.                 Manifest.permission.READ_CONTACTS)  
4.         != PackageManager.PERMISSION_GRANTED) {  
5.   
6.     // Should we show an explanation?  
7.     if (ActivityCompat.shouldShowRequestPermissionRationale(thisActivity,  
8.             Manifest.permission.READ_CONTACTS)) {  
9.   
10.         // Show an expanation to the user *asynchronously* -- don't block  
11.         // this thread waiting for the user's response! After the user  
12.         // sees the explanation, try again to request the permission.  
13.   
14.     } else {  
15.   
16.         // No explanation needed, we can request the permission.  
17.   
18.         ActivityCompat.requestPermissions(thisActivity,  
19.                 new String[]{Manifest.permission.READ_CONTACTS},  
20.                 MY_PERMISSIONS_REQUEST_READ_CONTACTS);  
21.   
22.         // MY_PERMISSIONS_REQUEST_READ_CONTACTS is an  
23.         // app-defined int constant. The callback method gets the  
24.         // result of the request.  
25.     }  
26. }  

四、简单的例子

这里写一个简单的例子，针对于运行时权限。相信大家在最开始接触Android的时候，都利用Intent实验了打电话、发短信等功能。

我们看看直接拨打电话在Android 6.x的设备上权限需要如何处理。

当然代码非常简单：

Java代码  

1. import android.Manifest;  
2. import android.content.Intent;  
3. import android.content.pm.PackageManager;  
4. import android.net.Uri;  
5. import android.os.Bundle;  
6. import android.support.v4.app.ActivityCompat;  
7. import android.support.v4.content.ContextCompat;  
8. import android.support.v7.app.AppCompatActivity;  
9. import android.view.View;  
10. import android.widget.Toast;  
11.   
12. public class MainActivity extends AppCompatActivity  
13. {  
14.   
15.     private static final int MY_PERMISSIONS_REQUEST_CALL_PHONE = 1;  
16.   
17.     @Override  
18.     protected void onCreate(Bundle savedInstanceState)  
19.     {  
20.         super.onCreate(savedInstanceState);  
21.         setContentView(R.layout.activity_main);  
22.     }  
23.   
24.     public void testCall(View view)  
25.     {  
26.         if (ContextCompat.checkSelfPermission(this,  
27.                 Manifest.permission.CALL_PHONE)  
28.                 != PackageManager.PERMISSION_GRANTED)  
29.         {  
30.   
31.             ActivityCompat.requestPermissions(this,  
32.                     new String[]{Manifest.permission.CALL_PHONE},  
33.                     MY_PERMISSIONS_REQUEST_CALL_PHONE);  
34.         } else  
35.         {  
36.             callPhone();  
37.         }  
38.     }  
39.   
40.     public void callPhone()  
41.     {  
42.         Intent intent = new Intent(Intent.ACTION_CALL);  
43.         Uri data = Uri.parse("tel:" + "10086");  
44.         intent.setData(data);  
45.         startActivity(intent);  
46.     }  
47.   
48.     @Override  
49.     public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults)  
50.     {  
51.   
52.         if (requestCode == MY_PERMISSIONS_REQUEST_CALL_PHONE)  
53.         {  
54.             if (grantResults[0] == PackageManager.PERMISSION_GRANTED)  
55.             {  
56.                 callPhone();  
57.             } else  
58.             {  
59.                 // Permission Denied  
60.                 Toast.makeText(MainActivity.this, "Permission Denied", Toast.LENGTH_SHORT).show();  
61.             }  
62.             return;  
63.         }  
64.         super.onRequestPermissionsResult(requestCode, permissions, grantResults);  
65.     }  
66. }  

在Android 6.x上运行是，点击testCall，即会弹出授权窗口，如何你Allow则直接拨打电话，如果Denied则Toast弹出”Permission Denied”。

例子很简单，不过需要注意的是，对于Intent这种方式，很多情况下是不需要授权的甚至权限都不需要的，比如：你是到拨号界面而不是直接拨打电话，就不需要去申请权限；打开系统图库去选择照片；调用系统相机app去牌照等。更多请参考[url= Consider Using an Intent
]Consider Using an Intent [/url]
.

当然，上例也说明了并非所有的通过Intent的方式都不需要申请权限。一般情况下，你是通过Intent打开另一个app，让用户通过该app去做一些事情，你只关注结果（onActivityResult），那么权限是不需要你处理的，而是由打开的app去处理。

五、封装

（1）申请权限

虽然权限处理并不复杂，但是需要编写很多重复的代码，所以目前也有很多库对用法进行了封装，大家可以在github首页搜索:android permission，对比了几个库的使用方式，发现https://github.com/lovedise/PermissionGen这个库据我所见相比较而言使用算是比较简单的，那么就以这个库的源码为基础来讲解，大家有兴趣可以多看几个库的源码。

封装的代码很简单，正如大家的对上面的权限代码所见，没有特别复杂的地方。

对于申请权限的代码，原本的编写为：

Java代码  

1. if (ContextCompat.checkSelfPermission(this,  
2.                 Manifest.permission.CALL_PHONE)  
3.                 != PackageManager.PERMISSION_GRANTED)  
4. {  
5.   
6.     ActivityCompat.requestPermissions(this,  
7.             new String[]{Manifest.permission.CALL_PHONE},  
8.             MY_PERMISSIONS_REQUEST_CALL_PHONE);  
9. } else  
10. {  
11.     callPhone();  
12. }  

大家可以看到，对于其他的权限，其实申请的逻辑是类似的；唯一不同的肯定就是参数，那么看上面的代码，我们需要3个参数:Activity|Fragment、权限字符串数组、int型申请码。

也就是说，我们只需要写个方法，接受这几个参数即可，然后逻辑是统一的。

Java代码  

1. public static void needPermission(Fragment fragment, int requestCode, String[] permissions)  
2. {  
3.     requestPermissions(fragment, requestCode, permissions);  
4. }  
5.   
6. @TargetApi(value = Build.VERSION_CODES.M)  
7. private static void requestPermissions(Object object, int requestCode, String[] permissions)  
8. {  
9.     if (!Utils.isOverMarshmallow())  
10.     {  
11.         doExecuteSuccess(object, requestCode);  
12.         return;  
13.     }  
14.     List<String> deniedPermissions = Utils.findDeniedPermissions(getActivity(object), permissions);  
15.   
16.     if (deniedPermissions.size() > 0)  
17.     {  
18.         if (object instanceof Activity)  
19.         {  
20.             ((Activity) object).requestPermissions(deniedPermissions.toArray(new String[deniedPermissions.size()]), requestCode);  
21.         } else if (object instanceof Fragment)  
22.         {  
23.             ((Fragment) object).requestPermissions(deniedPermissions.toArray(new String[deniedPermissions.size()]), requestCode);  
24.         } else  
25.         {  
26.             throw new IllegalArgumentException(object.getClass().getName() + " is not supported");  
27.         }  
28.   
29.     } else  
30.     {  
31.         doExecuteSuccess(object, requestCode);  
32.     }  
33. }  

Utils.findDeniedPermissions其实就是check没有授权的权限。

Java代码  

1. #Utils  
2. @TargetApi(value = Build.VERSION_CODES.M)  
3. public static List<String> findDeniedPermissions(Activity activity, String... permission)  
4. {  
5.     List<String> denyPermissions = new ArrayList<>();  
6.     for (String value : permission)  
7.     {  
8.         if (activity.checkSelfPermission(value) != PackageManager.PERMISSION_GRANTED)  
9.         {  
10.             denyPermissions.add(value);  
11.         }  
12.     }  
13.     return denyPermissions;  
14. }  

那么上述的逻辑就很清晰了，需要的3种参数传入，先去除已经申请的权限，然后开始申请权限。

ok，我相信上面代码，大家扫一眼就可以了解了。

（2）处理权限回调

对于回调，因为要根据是否授权去执行不同的事情，所以很多框架也需要些一连串的代码，或者和前面的申请代码耦合。不过这个框架还是比较方便的，也是我选择它来讲解的原因。

回调主要做的事情：

• 了解是否授权成功。
• 根据授权情况进行回调。

对于第一条逻辑都一样；对于第二条，因为涉及到两个分支，每个分支执行不同的方法。

对于第二条，很多框架选择将两个分支的方法在申请权限的时候进行注册，然后在回调中根据requestCode进行匹配执行，不过这样需要在针对每次申请进行对象管理。

不过这个框架采取了一种很有意思的做法，它利用注解去确定需要执行的方法，存在两个注解：

Java代码  

1. @PermissionSuccess(requestCode = 100)  
2. @PermissionFail(requestCode = 100)  

利用反射根据授权情况+requestCode即可找到注解标注的方法，然后直接执行即可。

大致的代码为：

Java代码  

1. @Override public void onRequestPermissionsResult(int requestCode, String[] permissions,  
2.       int[] grantResults) {  
3.     PermissionGen.onRequestPermissionsResult(this, requestCode, permissions, grantResults);  
4. }  
5.   
6. private static void requestResult(Object obj, int requestCode, String[] permissions,  
7.                                   int[] grantResults)  
8. {  
9.     List<String> deniedPermissions = new ArrayList<>();  
10.     for (int i = 0; i < grantResults.length; i++)  
11.     {  
12.         if (grantResults[i] != PackageManager.PERMISSION_GRANTED)  
13.         {  
14.             deniedPermissions.add(permissions[i]);  
15.         }  
16.     }  
17.   
18.     if (deniedPermissions.size() > 0)  
19.     {  
20.         doExecuteFail(obj, requestCode);  
21.     } else  
22.     {  
23.         doExecuteSuccess(obj, requestCode);  
24.     }  
25. }  

首先根据grantResults进行判断成功还是失败，对于成功则：

Java代码  

1. private static void doExecuteSuccess(Object activity, int requestCode)  
2. {  
3.     Method executeMethod = Utils.findMethodWithRequestCode(activity.getClass(),  
4.             PermissionSuccess.class, requestCode);  
5.   
6.     executeMethod(activity, executeMethod);  
7. }  
8.   
9. #Utils  
10. public static <A extends Annotation> Method findMethodWithRequestCode(Class clazz,  Class<A> annotation, int requestCode)  
11. {  
12.     for (Method method : clazz.getDeclaredMethods())  
13.     {  
14.         if (method.isAnnotationPresent(annotation))  
15.         {  
16.             if (isEqualRequestCodeFromAnntation(method, annotation, requestCode))  
17.             {  
18.                 return method;  
19.             }  
20.         }  
21.     }  
22.     return null;  
23. }  

根据注解和requestCode找到方法，然后反射执行即可。失败的逻辑类似，不贴代码了。

ok，到此我们的运行时权限相对于早起版本的变化、特点、以及如何处理和封装都介绍完了。

不过对于上面讲解的库，肯定有人会说：运行时反射会影响效率，没错，不过我已经在上述代码的基础上将运行时注解改成Annotation Processor的方式了，即编译时注解，这样的话，就不存在反射损失效率的问题了。本来准备fork修改，然后PR，结果写完，改动太大，估计PR是不可能通过了，所以另起项目了，也方便后面的做一些扩展和维护。

详见库：https://github.com/hongyangAndroid/MPermissions.

六、MPermissions用法

对外的接口和PermissionGen基本一致，因为申请只需要三个参数，抛弃了使用原本类库的单例的方式，直接一个几个静态方法，简单整洁暴力。

贴一个用法：

Java代码  

1. public class MainActivity extends AppCompatActivity  
2. {  
3.   
4.     private Button mBtnSdcard;  
5.     private static final int REQUECT_CODE_SDCARD = 2;  
6.   
7.     @Override  
8.     protected void onCreate(Bundle savedInstanceState)  
9.     {  
10.         super.onCreate(savedInstanceState);  
11.         setContentView(R.layout.activity_main);  
12.   
13.         mBtnSdcard = (Button) findViewById(R.id.id_btn_sdcard);  
14.         mBtnSdcard.setOnClickListener(new View.OnClickListener()  
15.         {  
16.             @Override  
17.             public void onClick(View v)  
18.             {  
19.                 MPermissions.requestPermissions(MainActivity.this, REQUECT_CODE_SDCARD, Manifest.permission.WRITE_EXTERNAL_STORAGE);  
20.             }  
21.         });  
22.     }  
23.   
24.     @Override  
25.     public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults)  
26.     {  
27.         MPermissions.onRequestPermissionsResult(this, requestCode, permissions, grantResults);  
28.         super.onRequestPermissionsResult(requestCode, permissions, grantResults);  
29.     }  
30.   
31.   
32.     @PermissionGrant(REQUECT_CODE_SDCARD)  
33.     public void requestSdcardSuccess()  
34.     {  
35.         Toast.makeText(this, "GRANT ACCESS SDCARD!", Toast.LENGTH_SHORT).show();  
36.     }  
37.   
38.     @PermissionDenied(REQUECT_CODE_SDCARD)  
39.     public void requestSdcardFailed()  
40.     {  
41.         Toast.makeText(this, "DENY ACCESS SDCARD!", Toast.LENGTH_SHORT).show();  
42.     }  
43. }  

是不是简单明了~~对于onRequestPermissionsResult所有的Activity都是一致的，所以可以放到BaseActivity中去。此外，在Fragment中使用的方式一致，详见demo。

详见库：https://github.com/hongyangAndroid/MPermissions.

至于为什么不直接介绍MPermission的源码，因为主要涉及到Annotation Processor，所以以这种方式引出，后面考虑单篇博文介绍下我目前所会的编译时注解的相关做法以及API的使用。

最后感谢PermissionGen库！