转载于红黑联盟
太好听了 直接放在这里了
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来了解运行时权限的处理,先上图
第一次申请权限,拒绝后再次申请,申请成功
多次拒绝后,点击不再提示
二话不说,上代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
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,在此判断中提示用户权限已被禁止,需要在应用管理中自行打开。
1
2
3
|
if
(!ActivityCompat.shouldShowRequestPermissionRationale(
this
, Manifest.permission.CAMERA)) {
Toast.makeText(
this
,
"相机权限已被禁止"
, Toast.LENGTH_SHORT).show();
}
|
shouldShowRequestPermissionRationale()说明
1
2
3
4
5
6
7
8
|
第一次请求权限时,如果用户拒绝了,再次请求时 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: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,如下图所示:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
注释此活动或碎片
@NeedsPermission
(Required)
当申请的权限被用户允许后,调用此方法。
@OnShowRationale
当第一次申请权限时,用户选择拒绝,再次申请时调用此方法,在此方法中提示用户为什么需要这个权限,这需要展现给用户,而用户可以选择“继续”或者“中止”当前的权限许可
@OnPermissionDenied
当申请的权限被用户拒绝后,调用此方法
@OnNeverAskAgain
当用户点击“不再询问”后,调用此方法。
MainActivityPermissionsDispatcher.showXXXXWithCheck(MainActivity.
this
);
此方法用于在适当时候获取权限,具体内容可以在生成的辅助类MainActivityPermissionsDispatcher中间查看 ,MainActivityPermissionsDispatcher是动态申请权限类,也可能是其他名称
最后要调用辅助类处理放回的结果
|
代码处理如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
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包的兼容方法:
1
2
3
4
5
|
ActivityCompat.requestPermissions()
ActivityCompat.OnRequestPermissionsResultCallback
ActivityCompat.shouldShowRequestPermissionRationale()
|
当targetSdkVersion小于23,但是设备是6.0系统时:
设备权限模型使用老的版本 清单文件中列出的权限只会在安装时询问 用户可以在设置列表中编辑相关权限,这对应用能否正常运行有很大影响
当targetSdkVersion大于等于23,但是设备系统小于6.0时:
设备权限模型使用老的版本 清单文件中列出的权限只会在安装时询问