1. 概述
Android 6.0 (API 23) 之前应用的权限在安装时全部授予,运行时应用不再需要询问用户。在 Android 6.0 或更高版本对权限进行了分类,对某些涉及到用户隐私的权限可在运行时根据用户的需要动态授予。这样就不需要在安装时被强迫同意某些权限。
2. 正常权限 和 危险权限
Android系统权限分为几个保护级别。需要了解的两个最重要保护级别是 正常权限 和 危险权限:
(1)正常权限:
涵盖应用需要访问其沙盒外部数据或资源,但对用户隐私或其他应用操作风险很小的区域。这些权限在应用安装时授予,运行时不再询问用户。例如: 网络访问、WIFI状态、音量设置等。完整的正常权限列表参考官网 正常权限。
(2)危险权限:
涵盖应用需要涉及用户隐私信息的数据或资源,或者可能对用户存储的数据或其他应用的操作产生影响的区域。例如: 读取通讯录、读写存储器数据、获取用户位置等。如果应用声明需要这些危险权限,则必须在运行时明确告诉用户,让用户手动授予。
3. 权限组
Android系统对所有的危险权限进行了分组,称为 权限组 。属于同一组的危险权限将自动合并授予,用户授予应用某个权限组的权限,则应用将获得该权限组下的所有权限(前提是相关权限在 AndroidManifest.xml 中有声明)。
危险权限 和 权限组 列表如下:
PS: 在 AndroidManifest.xml 声明过的危险权限对应的权限组可以在系统 “设置” -> “应用” -> “应用信息” -> “权限” 中查看,可以手动授权和取消授权。
权限组和权限在Android代码中以 字符串常量 来表示,分别定义在以下两个 静态内部类 的字段中:
- android.Manifest.permission_group(权限组):
Manifest.permission_group.CALENDAR
Manifest.permission_group.STORAGE
......
- android.Manifest.permission(权限):
Manifest.permission.READ_CALENDAR
Manifest.permission.READ_EXTERNAL_STORAGE
......
4. 在运行时请求权限
设备系统是 Android 6.0 (API 23) 或更高版本,并且应用的 targetSdkVersion 是 23 或更高版本,则针对在 AndroidManifest.xml 中声明的危险权限,在运行时还需要动态请求用户授权。
动态权限请求相关操作的API封装在在android.support.v4
包中,发起请求权限的Activity
需要直接或间接继承android.support.v4.app.FragmentActivity
。
PS: 也可以在直接或间接继承 android.support.v4.app.Fragment
的 Fragment
中发起权限请求。
代码步骤中主要包含以下几个方法:
(1)检查权限
// 检查权限 ContextCompat.checkSelfPermission(Context context, String permission)
返回值(android.content.pm.PackageManager
中的常量):
- 有权限:
PackageManager.PERMISSION_GRANTED
- 无权限:
PackageManager.PERMISSION_DENIED
当应用需要用到危险权限时,在执行权限相关代码前,使用该方法判断是否拥有指定的权限。有权限,则继续执行设计需要权限的代码;无权限,则向用户请求授予权限。
(2)解释权限
// 解释权限 ActivityCompat.shouldShowRequestPermissionRationale(Activity activity, String permission)
判断是否有必要向用户解释为什么要这项权限。如果应用第一次请求过此权限,但是被用户拒绝了,则之后调用该方法将返回 true,此时就有必要向用户详细说明需要此权限的原因(个人认为此方法是可选的)。
PS: 如果应用第一次请求此权限时被用户拒绝,第二次再请求此权限时,用户勾选了权限请求对话框的“不再询问”,则此方法返回 false。如果设备规范禁止应用拥有该权限,此方法也返回 false。
(3)请求权限
// 请求权限 ActivityCompat.requestPermissions(Activity activity, String[] permissions, int requestCode)
PS:
- 权限参数传入的是数组,可以调用该方法一次请求多个权限;
- 传入的权限数组参数以单个具体权限为单位,但弹框询问用户授权时,属于同一权限组的权限将自动合并询问授权一次;
- 请求的权限必须事先在 AndroidManifest.xml 中有声明,否则调用此方法请求时,将不弹框,而是直接返回“拒绝”的结果;
- 第一次请求权限时,用户点击了“拒绝”,第二次再请求该权限时,对话框将出现“不再询问”复选框,如果用户勾选了“不再询问”并点击了“拒绝”,则之后再请求此权限组时将不弹框,而是直接返回“拒绝”的结果。
(4)处理结果
请求权限的结果返回和接收一个Activity的返回类似,重写 FragmentActivity
或 (v4) Fragment
中的 onRequestPermissionsResult(...)
方法。
/*** 处理权限请求结果** @param requestCode* 请求权限时传入的请求码,用于区别是哪一次请求的** @param permissions* 所请求的所有权限的数组** @param grantResults* 权限授予结果,和 permissions 数组参数中的权限一一对应,元素值为两种情况,如下:* 授予: PackageManager.PERMISSION_GRANTED* 拒绝: PackageManager.PERMISSION_DENIED*/ @Override public void onRequestPermissionsResult(int requestCode, String permissions[], int[] grantResults) {// ... }
5. 代码演示
功能很简单,如下:
- 点击一个按钮,如果有相应权限就进行备份通讯录操作;
- 如果没有相应的权限,则向用户申请权限;
- 如果用户授权通过,则继续进行备份通讯录操作;
- 如果用户拒绝授权,则弹出对话框引导用户跳转到应用权限管理界面手动授权。
效果大致如下:
部分文件代码:
1、首先在 AndroidManifest.xml 中声明权限
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android"package="com.xiets.demoapp"><!-- 声明所有需要的权限(包括普通权限和危险权限) --><uses-permission android:name="android.permission.READ_CONTACTS"/><uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/><applicationandroid:icon="@mipmap/ic_launcher"android:label="@string/app_name"android:theme="@style/AppTheme"><activity android:name=".MainActivity"><intent-filter><action android:name="android.intent.action.MAIN" /><category android:name="android.intent.category.LAUNCHER" /></intent-filter></activity></application></manifest>
2、布局文件 activity_main.xml
<?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"android:layout_width="match_parent"android:layout_height="match_parent"android:padding="10dp"><Buttonandroid:layout_width="match_parent"android:layout_height="wrap_content"android:onClick="click"android:textSize="20sp"android:text="备份通讯录" /></RelativeLayout>
3、MainActivity
package com.xiets.demoapp;import android.Manifest; import android.content.DialogInterface; import android.content.Intent; import android.content.pm.PackageManager; import android.net.Uri; import android.os.Bundle; import android.provider.Settings; import android.support.annotation.NonNull; 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.view.View; import android.widget.Toast;/*** 一键备份通讯录** @author xietansheng*/ public class MainActivity extends AppCompatActivity {private static final int MY_PERMISSION_REQUEST_CODE = 10000;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);}/*** 点击按钮,将通讯录备份保存到外部存储器备。** 需要3个权限(都是危险权限):* 1. 读取通讯录权限;* 2. 读取外部存储器权限;* 3. 写入外部存储器权限.*/public void click(View view) {/*** 第 1 步: 检查是否有相应的权限*/boolean isAllGranted = checkPermissionAllGranted(new String[] {Manifest.permission.READ_CONTACTS,Manifest.permission.READ_EXTERNAL_STORAGE,Manifest.permission.WRITE_EXTERNAL_STORAGE});// 如果这3个权限全都拥有, 则直接执行备份代码if (isAllGranted) {doBackup();return;}/*** 第 2 步: 请求权限*/// 一次请求多个权限, 如果其他有权限是已经授予的将会自动忽略掉 ActivityCompat.requestPermissions(this,new String[] {Manifest.permission.READ_CONTACTS,Manifest.permission.READ_EXTERNAL_STORAGE,Manifest.permission.WRITE_EXTERNAL_STORAGE},MY_PERMISSION_REQUEST_CODE);}/*** 检查是否拥有指定的所有权限*/private boolean checkPermissionAllGranted(String[] permissions) {for (String permission : permissions) {if (ContextCompat.checkSelfPermission(this, permission) != PackageManager.PERMISSION_GRANTED) {// 只要有一个权限没有被授予, 则直接返回 falsereturn false;}}return true;}/*** 第 3 步: 申请权限结果返回处理*/@Overridepublic void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {super.onRequestPermissionsResult(requestCode, permissions, grantResults);if (requestCode == MY_PERMISSION_REQUEST_CODE) {boolean isAllGranted = true;// 判断是否所有的权限都已经授予了for (int grant : grantResults) {if (grant != PackageManager.PERMISSION_GRANTED) {isAllGranted = false;break;}}if (isAllGranted) {// 如果所有的权限都授予了, 则执行备份代码 doBackup();} else {// 弹出对话框告诉用户需要权限的原因, 并引导用户去应用权限管理中手动打开权限按钮 openAppDetails();}}}/*** 第 4 步: 备份通讯录操作*/private void doBackup() {// 本文主旨是讲解如果动态申请权限, 具体备份代码不再展示, 就假装备份一下Toast.makeText(this, "正在备份通讯录...", Toast.LENGTH_SHORT).show();}/*** 打开 APP 的详情设置*/private void openAppDetails() {AlertDialog.Builder builder = new AlertDialog.Builder(this);builder.setMessage("备份通讯录需要访问 “通讯录” 和 “外部存储器”,请到 “应用信息 -> 权限” 中授予!");builder.setPositiveButton("去手动授权", new DialogInterface.OnClickListener() {@Overridepublic void onClick(DialogInterface dialog, int which) {Intent intent = new Intent();intent.setAction(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);intent.addCategory(Intent.CATEGORY_DEFAULT);intent.setData(Uri.parse("package:" + getPackageName()));intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);intent.addFlags(Intent.FLAG_ACTIVITY_NO_HISTORY);intent.addFlags(Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS);startActivity(intent);}});builder.setNegativeButton("取消", null);builder.show();}}