1.介绍
Runtime Permissions官方说明
Android 6.0之前,权限在应用安装过程中只询问一次,以列表的形式展现给用户,然而大多数用户并不会注意到这些,直接就下一步了,应用安装成功后就会被赋予清单文件中的所有权限,应用就可以在用户不知情的情况下进行非法操作(比如偷偷的上传用户数据)。
Android 6.0版本中运行时权限的出现解决的这一问题,一些高危权限会在应用的运行过程中动态申请,这样用户就可以选择是否允许,比如一个单机游戏要获取通讯录权限,那肯定要禁止了。
并不是所有的权限都需要动态申请,需要申请的权限如下表所示:
注意:同一组的任何一个权限被授权了,其他权限也自动被授权。例如,一旦READ_CALENDAR被授权了,应用也有WRITE_CALENDAR权限了。
Permission Group | Permissions |
---|---|
CALENDAR | 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 |
2.运行时权限处理
通过一个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。
3.第三方库PermissionsDispatcher
PermissionsDispatcher通过注解的方式,动态生成类处理运行时权限。配合插件使用,可自动生成代码。
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:
}
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);
此方法用于在适当时候获取权限,具体内容可以在生成的辅助类MainActivityPermissionsDispatcher中间查看 ,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();
}
}
4.兼容性
为了保持兼容性建议使用v4包的兼容方法:
ContextCompat.checkSelfPermission()
ActivityCompat.requestPermissions()
ActivityCompat.OnRequestPermissionsResultCallback
ActivityCompat.shouldShowRequestPermissionRationale()
当targetSdkVersion小于23,但是设备是6.0系统时:
设备权限模型使用老的版本 清单文件中列出的权限只会在安装时询问 用户可以在设置列表中编辑相关权限,这对应用能否正常运行有很大影响
当targetSdkVersion大于等于23,但是设备系统小于6.0时:
设备权限模型使用老的版本 清单文件中列出的权限只会在安装时询问