首页 > 代码库 > Android 6.0 执行时权限处理全然解析
Android 6.0 执行时权限处理全然解析
转载请标明出处:
http://blog.csdn.net/lmj623565791/article/details/50709663;
本文出自:【张鸿洋的博客】
一、概述
随着Android 6.0公布以及普及。我们开发人员所要应对的主要就是新版本号SDK带来的一些变化,首先关注的就是权限机制的变化。对于6.0的几个基本的变化,查看查看官网的这篇文章http://developer.android.com/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例如以下
ACCESS_LOCATION_EXTRA_COMMANDS
ACCESS_NETWORK_STATE
ACCESS_NOTIFICATION_POLICY
ACCESS_WIFI_STATE
BLUETOOTH
BLUETOOTH_ADMIN
BROADCAST_STICKY
CHANGE_NETWORK_STATE
CHANGE_WIFI_MULTICAST_STATE
CHANGE_WIFI_STATE
DISABLE_KEYGUARD
EXPAND_STATUS_BAR
GET_PACKAGE_SIZE
INSTALL_SHORTCUT
INTERNET
KILL_BACKGROUND_PROCESSES
MODIFY_AUDIO_SETTINGS
NFC
READ_SYNC_SETTINGS
READ_SYNC_STATS
RECEIVE_BOOT_COMPLETED
REORDER_TASKS
REQUEST_INSTALL_PACKAGES
SET_ALARM
SET_TIME_ZONE
SET_WALLPAPER
SET_WALLPAPER_HINTS
TRANSMIT_IR
UNINSTALL_SHORTCUT
USE_FINGERPRINT
VIBRATE
WAKE_LOCK
WRITE_SYNC_SETTINGS
- Dangerous Permissions:
group:android.permission-group.CONTACTS
permission:android.permission.WRITE_CONTACTS
permission:android.permission.GET_ACCOUNTS
permission:android.permission.READ_CONTACTS
group:android.permission-group.PHONE
permission:android.permission.READ_CALL_LOG
permission:android.permission.READ_PHONE_STATE
permission:android.permission.CALL_PHONE
permission:android.permission.WRITE_CALL_LOG
permission:android.permission.USE_SIP
permission:android.permission.PROCESS_OUTGOING_CALLS
permission:com.android.voicemail.permission.ADD_VOICEMAIL
group:android.permission-group.CALENDAR
permission:android.permission.READ_CALENDAR
permission:android.permission.WRITE_CALENDAR
group:android.permission-group.CAMERA
permission:android.permission.CAMERA
group:android.permission-group.SENSORS
permission:android.permission.BODY_SENSORS
group:android.permission-group.LOCATION
permission:android.permission.ACCESS_FINE_LOCATION
permission:android.permission.ACCESS_COARSE_LOCATION
group:android.permission-group.STORAGE
permission:android.permission.READ_EXTERNAL_STORAGE
permission:android.permission.WRITE_EXTERNAL_STORAGE
group:android.permission-group.MICROPHONE
permission:android.permission.RECORD_AUDIO
group:android.permission-group.SMS
permission:android.permission.READ_SMS
permission:android.permission.RECEIVE_WAP_PUSH
permission:android.permission.RECEIVE_MMS
permission:android.permission.RECEIVE_SMS
permission:android.permission.SEND_SMS
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的解说就跟着申请权限步骤一起了:
在AndroidManifest文件里加入须要的权限。
这个步骤和我们之前的开发并没有什么变化,试图去申请一个没有声明的权限可能会导致程序崩溃。
检查权限
if (ContextCompat.checkSelfPermission(thisActivity, Manifest.permission.READ_CONTACTS) != PackageManager.PERMISSION_GRANTED) { }else{ // }
这里涉及到一个API。
ContextCompat.checkSelfPermission
,主要用于检測某个权限是否已经被授予,方法返回值为PackageManager.PERMISSION_DENIED
或者PackageManager.PERMISSION_GRANTED
。当返回DENIED就须要进行申请授权了。
申请授权
ActivityCompat.requestPermissions(thisActivity, new String[]{Manifest.permission.READ_CONTACTS}, MY_PERMISSIONS_REQUEST_READ_CONTACTS);
该方法是异步的,第一个參数是Context;第二个參数是须要申请的权限的字符串数组。第三个參数为requestCode,主要用于回调的时候检測。
能够从方法名
requestPermissions
以及第二个參数看出,是支持一次性申请多个权限的。系统会通过对话框逐一询问用户是否授权。处理权限申请回调
@Override public void onRequestPermissionsResult(int requestCode, String permissions[], int[] grantResults) { switch (requestCode) { case MY_PERMISSIONS_REQUEST_READ_CONTACTS: { // If request is cancelled, the result arrays are empty. if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) { // permission was granted, yay! Do the // contacts-related task you need to do. } else { // permission denied, boo! Disable the // functionality that depends on this permission. } return; } } }
ok,对于权限的申请结果。首先验证requestCode定位到你的申请。然后验证grantResults相应于申请的结果,这里的数组相应于申请时的第二个权限字符串数组。假设你同一时候申请两个权限。那么grantResults的length就为2,分别记录你两个权限的申请结果。假设申请成功,就能够做你的事情了~
当然,到此我们的权限申请的不走,基本介绍就如上述。只是还有个API值得提一下:
// Should we show an explanation?
if (ActivityCompat.shouldShowRequestPermissionRationale(thisActivity,
Manifest.permission.READ_CONTACTS))
// Show an expanation to the user *asynchronously* -- don‘t block
// this thread waiting for the user‘s response! After the user
// sees the explanation, try again to request the permission.
}
这个API主要用于给用户一个申请权限的解释。该方法仅仅有在用户在上一次已经拒绝过你的这个权限申请。也就是说,用户已经拒绝一次了,你又弹个授权框。你须要给用户一个解释,为什么要授权,则使用该方法。
那么将上述几个步骤结合到一起就是:
// Here, thisActivity is the current activity
if (ContextCompat.checkSelfPermission(thisActivity,
Manifest.permission.READ_CONTACTS)
!= PackageManager.PERMISSION_GRANTED) {
// Should we show an explanation?
if (ActivityCompat.shouldShowRequestPermissionRationale(thisActivity,
Manifest.permission.READ_CONTACTS)) {
// Show an expanation to the user *asynchronously* -- don‘t block
// this thread waiting for the user‘s response! After the user
// sees the explanation, try again to request the permission.
} else {
// No explanation needed, we can request the permission.
ActivityCompat.requestPermissions(thisActivity,
new String[]{Manifest.permission.READ_CONTACTS},
MY_PERMISSIONS_REQUEST_READ_CONTACTS);
// MY_PERMISSIONS_REQUEST_READ_CONTACTS is an
// app-defined int constant. The callback method gets the
// result of the request.
}
}
四、简单的样例
这里写一个简单的样例,针对于执行时权限。相信大家在最開始接触Android的时候,都利用Intent实验了打电话、发短信等功能。
我们看看直接拨打电话在Android 6.x的设备上权限须要怎样处理。
当然代码非常easy:
package com.zhy.android160217;
import android.Manifest;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.net.Uri;
import android.os.Bundle;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.Toast;
public class MainActivity extends AppCompatActivity
{
private static final int MY_PERMISSIONS_REQUEST_CALL_PHONE = 1;
@Override
protected void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
public void testCall(View view)
{
if (ContextCompat.checkSelfPermission(this,
Manifest.permission.CALL_PHONE)
!= PackageManager.PERMISSION_GRANTED)
{
ActivityCompat.requestPermissions(this,
new String[]{Manifest.permission.CALL_PHONE},
MY_PERMISSIONS_REQUEST_CALL_PHONE);
} else
{
callPhone();
}
}
public void callPhone()
{
Intent intent = new Intent(Intent.ACTION_CALL);
Uri data = http://www.mamicode.com/Uri.parse("tel:" + "10086");
intent.setData(data);
startActivity(intent);
}
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults)
{
if (requestCode == MY_PERMISSIONS_REQUEST_CALL_PHONE)
{
if (grantResults[0] == PackageManager.PERMISSION_GRANTED)
{
callPhone();
} else
{
// Permission Denied
Toast.makeText(MainActivity.this, "Permission Denied", Toast.LENGTH_SHORT).show();
}
return;
}
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
}
}
在Android 6.x上执行是,点击testCall,即会弹出授权窗体,怎样你Allow则直接拨打电话。假设Denied则Toast弹出”Permission Denied”。
样例非常easy,只是须要注意的是。对于Intent这种方式。非常多情况下是不须要
授权的甚至权限都不须要的。比方:你是到拨号界面而不是直接拨打电话,就不须要去申请权限。打开系统图库去选择照片;调用系统相机app去牌照等。
很多其它请參考Consider Using an Intent
.
当然,上例也说明了并不是全部的通过Intent的方式都不须要申请权限。普通情况下,你是通过Intent打开还有一个app,让用户通过该app去做一些事情,你仅仅关注结果(onActivityResult),那么权限是不须要你处理的,而是由打开的app去处理。
五、封装
(1)申请权限
尽管权限处理并不复杂,可是须要编写非常多反复的代码。所以眼下也有非常多库对使用方法进行了封装。大家能够在github首页搜索:android permission
,对照了几个库的使用方式,发现https://github.com/lovedise/PermissionGen这个库据我所见相比較而言使用算是比較简单的,那么就以这个库的源代码为基础来解说,大家有兴趣能够多看几个库的源代码。
封装的代码非常easy,正如大家的对上面的权限代码所见,没有特别复杂的地方。
对于申请权限的代码,原本的编写为:
if (ContextCompat.checkSelfPermission(this,
Manifest.permission.CALL_PHONE)
!= PackageManager.PERMISSION_GRANTED)
{
ActivityCompat.requestPermissions(this,
new String[]{Manifest.permission.CALL_PHONE},
MY_PERMISSIONS_REQUEST_CALL_PHONE);
} else
{
callPhone();
}
大家能够看到,对于其它的权限。事实上申请的逻辑是相似的。唯一不同的肯定就是參数,那么看上面的代码,我们须要3个參数:Activity|Fragment
、权限字符串数组
、int型申请码
。
也就是说,我们仅仅须要写个方法,接受这几个參数就可以,然后逻辑是统一的。
public static void needPermission(Fragment fragment, int requestCode, String[] permissions)
{
requestPermissions(fragment, requestCode, permissions);
}
@TargetApi(value = http://www.mamicode.com/Build.VERSION_CODES.M)"hljs-keyword">private static void requestPermissions(Object object, int requestCode, String[] permissions)
{
if (!Utils.isOverMarshmallow())
{
doExecuteSuccess(object, requestCode);
return;
}
List<String> deniedPermissions = Utils.findDeniedPermissions(getActivity(object), permissions);
if (deniedPermissions.size() > 0)
{
if (object instanceof Activity)
{
((Activity) object).requestPermissions(deniedPermissions.toArray(new String[deniedPermissions.size()]), requestCode);
} else if (object instanceof Fragment)
{
((Fragment) object).requestPermissions(deniedPermissions.toArray(new String[deniedPermissions.size()]), requestCode);
} else
{
throw new IllegalArgumentException(object.getClass().getName() + " is not supported");
}
} else
{
doExecuteSuccess(object, requestCode);
}
}
Utils.findDeniedPermissions
事实上就是check没有授权的权限。
#Utils
@TargetApi(value = http://www.mamicode.com/Build.VERSION_CODES.M)"hljs-keyword">public static List<String> findDeniedPermissions(Activity activity, String... permission)
{
List<String> denyPermissions = new ArrayList<>();
for (String value : permission)
{
if (activity.checkSelfPermission(value) != PackageManager.PERMISSION_GRANTED)
{
denyPermissions.add(value);
}
}
return denyPermissions;
}
那么上述的逻辑就非常清晰了。须要的3种參数传入,先去除已经申请的权限,然后開始申请权限。
ok,我相信上面代码。大家扫一眼就能够了解了。
(2)处理权限回调
对于回调。由于要依据是否授权去执行不同的事情,所以非常多框架也须要些一连串的代码,或者和前面的申请代码耦合。
只是这个框架还是比較方便的,也是我选择它来解说的原因。
回调主要做的事情:
- 了解是否授权成功。
- 依据授权情况进行回调。
对于第一条逻辑都一样;对于第二条。由于涉及到两个分支。每一个分支执行不同的方法。
对于第二条,非常多框架选择将两个分支的方法在申请权限的时候进行注冊,然后在回调中依据requestCode进行匹配执行。只是这样须要在针对每次申请进行对象管理。
只是这个框架採取了一种非常有意思的做法。它利用注解去确定须要执行的方法,存在两个注解:
@PermissionSuccess(requestCode = 100)
@PermissionFail(requestCode = 100)
利用反射依据授权情况+requestCode就可以找到注解标注的方法。然后直接执行就可以。
大致的代码为:
@Override public void onRequestPermissionsResult(int requestCode, String[] permissions,
int[] grantResults) {
PermissionGen.onRequestPermissionsResult(this, requestCode, permissions, grantResults);
}
private static void requestResult(Object obj, int requestCode, String[] permissions,
int[] grantResults)
{
List<String> deniedPermissions = new ArrayList<>();
for (int i = 0; i < grantResults.length; i++)
{
if (grantResults[i] != PackageManager.PERMISSION_GRANTED)
{
deniedPermissions.add(permissions[i]);
}
}
if (deniedPermissions.size() > 0)
{
doExecuteFail(obj, requestCode);
} else
{
doExecuteSuccess(obj, requestCode);
}
}
首先依据grantResults进行推断成功还是失败,对于成功则:
private static void doExecuteSuccess(Object activity, int requestCode)
{
Method executeMethod = Utils.findMethodWithRequestCode(activity.getClass(),
PermissionSuccess.class, requestCode);
executeMethod(activity, executeMethod);
}
#Utils
public static <A extends Annotation> Method findMethodWithRequestCode(Class clazz, Class<A> annotation, int requestCode)
{
for (Method method : clazz.getDeclaredMethods())
{
if (method.isAnnotationPresent(annotation))
{
if (isEqualRequestCodeFromAnntation(method, annotation, requestCode))
{
return method;
}
}
}
return null;
}
依据注解和requestCode找到方法,然后反射执行就可以。失败的逻辑相似,不贴代码了。
ok。到此我们的执行时权限相对于早起版本号的变化、特点、以及怎样处理和封装都介绍完了。
只是对于上面解说的库,肯定有人会说:执行时反射会影响效率,没错,只是我已经在上述代码的基础上将执行时注解改成Annotation Processor的方式了,即编译时注解,这种话。就不存在反射损失效率的问题了。
本来准备fork修改,然后PR,结果写完。修改太大,预计PR是不可能通过了,所以另起项目了。也方便后面的做一些扩展和维护。
详见库:https://github.com/hongyangAndroid/MPermissions.
六、MPermissions使用方法
对外的接口和PermissionGen基本一致,由于申请仅仅须要三个參数,抛弃了使用原本类库的单例的方式,直接一个几个静态方法,简单整洁暴力。
贴一个使用方法:
public class MainActivity extends AppCompatActivity
{
private Button mBtnSdcard;
private static final int REQUECT_CODE_SDCARD = 2;
@Override
protected void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mBtnSdcard = (Button) findViewById(R.id.id_btn_sdcard);
mBtnSdcard.setOnClickListener(new View.OnClickListener()
{
@Override
public void onClick(View v)
{
MPermissions.requestPermissions(MainActivity.this, REQUECT_CODE_SDCARD, Manifest.permission.WRITE_EXTERNAL_STORAGE);
}
});
}
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults)
{
MPermissions.onRequestPermissionsResult(this, requestCode, permissions, grantResults);
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
}
@PermissionGrant(REQUECT_CODE_SDCARD)
public void requestSdcardSuccess()
{
Toast.makeText(this, "GRANT ACCESS SDCARD!", Toast.LENGTH_SHORT).show();
}
@PermissionDenied(REQUECT_CODE_SDCARD)
public void requestSdcardFailed()
{
Toast.makeText(this, "DENY ACCESS SDCARD!", Toast.LENGTH_SHORT).show();
}
}
是不是简单明了~~对于onRequestPermissionsResult全部的Activity都是一致的。所以能够放到BaseActivity中去。此外,在Fragment中使用的方式一致。详见demo。
详见库:https://github.com/hongyangAndroid/MPermissions.
至于为什么不直接介绍MPermission的源代码,由于主要涉及到Annotation Processor,所以以这种方式引出,后面考虑单篇博文介绍下我眼下所会的编译时注解的相关做法以及API的使用。
最后感谢PermissionGen
库。祝大家元宵节快乐~。
欢迎关注我的微博:
http://weibo.com/u/3165018720
讨论群:284327959,欢迎入群
微信公众号:hongyangAndroid
(欢迎关注。第一时间推送博文信息)
Android 6.0 执行时权限处理全然解析