Android 6.0 动态权限申请详解

前言

自从升级到Android M以来，最大的改变就是增加了运行时权限RuntimePermission，6.0以上的系统如果没有做适配，运行了targetSDK=23的App时就会报权限错误；当然如果你还没准备好适配权限，把targetSDK设置成小于23就ok了，不过适配是迟早的。

Android系统的常用权限

权限	说明
Manifest.permission.ACCESS_NETWORK_STATE	网络状态权限
ACCESS_WIFI_STATE	WIFI网络状态信息权限
BATTERY_STATE	电池状态权限
BLUETOOTH	连接匹配的蓝牙设备权限
BLUETOOTH_ADMIN	发现匹配的蓝牙设备权限
BROADCAST_SMS	广播收到短信提醒的权限
CALL_PHONE	拨打电话的权限
CAMERA	使用相机的权限
CHANGE_NETWORK_STATE	改变网络状态权限
CHANGE_WIFI_STATE	改变wifi网络状态权限
DELETE_CACHE_FILES	允许删除缓存文件权限
DELETE_PACKAGES	允许删除安装包的权限
FLASHLIGHT	访问闪光灯的权限
INTERNET	允许访问网络的权限
MODIFY_AUDIO_SETTINGS	允许修改全局声音的权限
PROCESS_OUTGOING_CALLS	允许监听、控制、取消呼出电话的权限
READ_CONTACTS	允许读取电话薄的权限
READ_HISTORY_BOOKMARKS	读取浏览器收藏夹和历史记录的权限
READ_OWNER_DATA	允许读取用户数据的权限
READ_PHONE_STATE	允许读取手机状态的权限
READ_PHONE_SMS	允许读取短信息的权限
REBOOT	允许重启系统的权限
RECEIVE_MMS	允许处理、监控、接受彩信的权限
RECEIVE_SMS	允许处理、监控、接受短信的权限
RECORD_AUDIO	允许录音的权限
SEND_SMS	允许发送短信的权限
SET_ORIENTATION	设置屏幕方向权限
SET_TIME	设置时间权限
SET_TIME_ZONE	允许设置时区的权限
SET_WALLPAPER	设置桌面壁纸权限
VIBRATE	允许控制振动器的权限
WRITE_CONTACTS	允许写用户联系人的权限
WRITE_HISTORY_BOOKMARKS	允许应用程序写历史记录和书签的全新
WRITE_OWNER_DATA	允许应用程序写用户数据的权限
WRITE_SMS	允许写短信的权限

运行时权限

谷歌官方将权限分为了两类，一个是正常权限（Normal Permissions），这类权限不涉及用户隐私，是不需要用户进行授权的，比如访问网络，手机震动等。还有一类是危险权限（Dangerous Permissions），一般是涉及到用户隐私的，需要用户进行授权，比如操作SD卡的写入，相机，录音等。

Permission Group	Permissions
CALENDAR	Manifest.permission.READ_CALENDAR , WRITE_CALENDAR
CAMERA	CAMERA
CONTACTS	READ_CONTACTS , WRITE_CONTACTS , GET_ACCOUNTS
LOCATION	ACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION
MICROPHONE	RECORD_AUDIO
PHONE	READ_PHONE_STATE ,CALL_PHONE READ_CALL_LOG, WRITE_CALL_LOG ADD_VOICEMAIL
SENSORS	BODY_SENSORS
SMS	SEND_SMS ,RECEIVE_SMS ,READ_SMS, RECEIVE_WAP_PUSH, RECEIVE_MMS
STORAGE	READ_EXTERNAL_STORAGE ,WRITE_EXTERNAL_STORAGE

我们所要关注的就是危险权限，由上图可以看到这些权限被分为不同的权限组(PermissionGroup)，这里需要说明一下，当一个权限组里的任一权限被授权，这个组里的其他权限也都会被授权，比如：Manifest.permission.READ_EXTERNAL_STORAGE这个读SD卡的权限被授权了，这时候Manifest.permission.WRITE_EXTERNAL_STORAGE也同时被授权。

运行时权限处理

通过一个Demo来了解运行时权限的处理，先上图

第一次申请权限，拒绝后再次申请，申请成功

多次拒绝后，点击不再提示

二话不说，上代码

package com.yang.permissiondemo;

import android.Manifest;
import android.annotation.TargetApi;
import android.content.DialogInterface;
import android.content.pm.PackageManager;
import android.graphics.Color;
import android.os.Build;
import android.os.Bundle;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AlertDialog;
import android.support.v7.app.AppCompatActivity;
import android.widget.TextView;
import android.widget.Toast;

import butterknife.Bind;
import butterknife.ButterKnife;
import butterknife.OnClick;

public class RuntimePermissionsActivity extends AppCompatActivity {

    @Bind(R.id.tv_permission_status)
    TextView tvPermissionStatus;

    private final int CAMERA_REQUEST_CODE = 1;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_permission);
        ButterKnife.bind(this);
    }

    @OnClick(R.id.btn_request_permission)
    public void onClick() {
        requestPermission();
    }

    @TargetApi(Build.VERSION_CODES.M)
    private void requestPermission() {
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA)
                != PackageManager.PERMISSION_GRANTED) {
            // 第一次请求权限时，用户如果拒绝，下一次请求shouldShowRequestPermissionRationale()返回true
            // 向用户解释为什么需要这个权限
            if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.CAMERA)) {
                new AlertDialog.Builder(this)
                        .setMessage("申请相机权限")
                        .setPositiveButton("确定", new DialogInterface.OnClickListener() {
                            @Override
                            public void onClick(DialogInterface dialog, int which) {
                                //申请相机权限
                                ActivityCompat.requestPermissions(RuntimePermissionsActivity.this,
                                        new String[]{Manifest.permission.CAMERA}, CAMERA_REQUEST_CODE);
                            }
                        })
                        .show();
            } else {
                //申请相机权限
                ActivityCompat.requestPermissions(this,
                        new String[]{Manifest.permission.CAMERA}, CAMERA_REQUEST_CODE);
            }
        } else {
            tvPermissionStatus.setTextColor(Color.GREEN);
            tvPermissionStatus.setText("相机权限已申请");
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == CAMERA_REQUEST_CODE) {
            if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                tvPermissionStatus.setTextColor(Color.GREEN);
                tvPermissionStatus.setText("相机权限已申请");
            } else {
                //用户勾选了不再询问
                //提示用户手动打开权限
                if (!ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.CAMERA)) {
                    Toast.makeText(this, "相机权限已被禁止", Toast.LENGTH_SHORT).show();
                }
            }
        }
    }
}

首先来看requestPermission方法

1>首先判断当前应用有没有CAMERA权限，如果没有则进行申请。

if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA)
!= PackageManager.PERMISSION_GRANTED)

2>如果没有CAMERA权限，进行如下判断，当第一次申请权限时 shouldShowRequestPermissionRationale返回false，第一次用户拒绝，再次申请的时候返回true，在此判断中提示用户为什么要申请这个权限。

if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.CAMERA))

3>如果用户点击了允许，则调用requestPermissions方法申请权限，注意里面接收的参数是一个String数组，也就是说可以同时申请多个权限，不过不建议这么做。

//申请相机权限
ActivityCompat.requestPermissions(this,
new String[]{Manifest.permission.CAMERA}, CAMERA_REQUEST_CODE);

onRequestPermissionsResult回调方法

此方法是权限申请的回调方法，在此方法中处理权限申请成功或失败后的操作。

1>因为可以同时申请多个权限，所以回调的结果是以数组方式返回的，如果用户点击允许的话，此判断为true，可以在里面处理打开摄像头的操作。

if (grantResults[0] == PackageManager.PERMISSION_GRANTED)

2>当多次（两次或两次以上）请求操作时，会有不再提示的选择框，如果用户选择了不再提示，shouldShowRequestPermissionRationale为false，在此判断中提示用户权限已被禁止，需要在应用管理中自行打开。

if (!ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.CAMERA)) {
                    Toast.makeText(this, "相机权限已被禁止", Toast.LENGTH_SHORT).show();
                }

shouldShowRequestPermissionRationale()说明

shouldShowRequestPermissionRationale() 默认返回 false。

第一次请求权限时，如果用户拒绝了，再次请求时 shouldShowRequestPermissionRationale() 返回 true。

多次请求权限（超过一次），用户如果选择了不再提醒并拒绝，shouldShowRequestPermissionRationale() 返回 false。

设备的策略禁止当前应用获取这个权限的授权，shouldShowRequestPermissionRationale() 返回 false。

第三方库PermissionsDispatcher

PermissionsDispatcher是一个通过注解在编译期间生成权限检查代码的工具，以最少的改动来让你的App对权限进行适配。配合插件使用，可自动生成代码。

github地址：https://github.com/hotchemi/PermissionsDispatcher

使用方法如下：

1>将下面这段代码添加到project的build.gradle文件中。

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

2>将下面的代码添加到app module的build.gradle文件中，${latest.version}填写最新的版本号，目前为2.1.3。

apply plugin: 'android-apt'

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

3>在Android Studio中选择File——Setting——Plugins，搜索PermissionsDispatcher，点击install安装，如下图所示：

4>准备工作已经完成了，下面来进行代码的生成，在Android Studio中选择Code——Generate——Generate Runtime Permissions，如下图所示：

@RuntimePermissions （Required）
注释需要进行权限判断的活动或碎片 

@NeedsPermission（Required）
当申请的权限被用户允许后，调用此方法。

@OnShowRationale
当第一次申请权限时，用户选择拒绝，再次申请时调用此方法，在此方法中提示用户为什么需要这个权限，这需要展现给用户，而用户可以选择“继续”或者“中止”当前的权限许可

@OnPermissionDenied
当申请的权限被用户拒绝后，调用此方法

@OnNeverAskAgain
当用户点击“不再询问”后，调用此方法。

MainActivityPermissionsDispatcher.showXXXXWithCheck(MainActivity.this);
Make编译一下，就会生成【当前类名+PermissionsDispatcher】的类，此方法用于在适当时候获取权限，具体内容可以在生成的辅助类MainActivityPermissionsDispatcher【当前类名+PermissionsDispatcher】中查看 ，MainActivityPermissionsDispatcher是动态申请权限类，也可能是其他名称

代码处理如下：

@RuntimePermissions
public class MainActivity extends AppCompatActivity {
    Button mycamera;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mycamera = (Button)findViewById(R.id.mycamera);
        mycamera.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
              MainActivityPermissionsDispatcher.openCameraWithCheck(MainActivity.this);
            }
        });
    }

    @NeedsPermission(Manifest.permission.CAMERA)
    void openCamera() {
        //处理当用户允许该权限时需要处理的方法 
        Intent intent = new Intent("android.media.action.IMAGE_CAPTURE");
        startActivity(intent);
    }

    /** 
     * 权限请求回调，提示用户之后，用户点击“允许”或者“拒绝”之后调用此方法 
     * @param requestCode  定义的权限编码 
     * @param permissions 权限名称 
     * @param grantResults 允许/拒绝 
     */
    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        MainActivityPermissionsDispatcher.onRequestPermissionsResult(this, requestCode, grantResults);
    }

    @OnShowRationale(Manifest.permission.CAMERA)
    void showRationale(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.CAMERA)
    void permissionDenied() {
        Toast.makeText(this, "权限被拒绝", Toast.LENGTH_SHORT).show();
    }
    /** 
     * 如果用户选取了“不再询问”时执行的方法 
     */ 
    @OnNeverAskAgain(Manifest.permission.CAMERA)
    void neverAskAgain() {
        Toast.makeText(this, "拍照权限被禁用，如果要使用拍照请手动启用", Toast.LENGTH_SHORT).show();
    }
}

原理

PermissionsDispatcher在编译期间，对需要权限判断的方法前后进行修饰，增加权限检查、获取逻辑，我们打开生成的代码看看便知道了,这里边并没有什么高深的东西。

兼容性

为了保持兼容性建议使用v4包的兼容方法：

ContextCompat.checkSelfPermission()
ActivityCompat.requestPermissions()
ActivityCompat.OnRequestPermissionsResultCallback
ActivityCompat.shouldShowRequestPermissionRationale()

当targetSdkVersion小于23，但是设备是6.0系统时：
设备权限模型使用老的版本 清单文件中列出的权限只会在安装时询问 用户可以在设置列表中编辑相关权限，这对应用能否正常运行有很大影响

当targetSdkVersion大于等于23，但是设备系统小于6.0时：
设备权限模型使用老的版本 清单文件中列出的权限只会在安装时询问
参考：Android 6.0运行时权限详解（http://www.2cto.com/kf/201609/547594.html）