1.4 Android6.0权限管理-开源框架源码分析
引言
Android6.0这个系统中迎来的最大的特征莫过于就是它的权限管理,因为小猪在写教程的时候应该6.0还没出,但是我感觉随着Android6.0的普及,对于它的权限管理是开发中必备的技能,同时也是基础。
乱入一些话
对于这种开发中所必备的技能,已经系统对此的简化操作,很多博主已经写了类似的博客。这里感觉我再废话一篇文章依旧是废话。
但是同样是基础,同样大家面临着Android6.0的权限管理,不同人对此的解决方案会有不同,所以这篇文章不妨带大家分析几个github上的开源框架上是如何解决(封装)这个权限管理的。
PermissionGen
在鸿神一篇中提到一篇相对基础的权限管理框架,那么接下来我们就围绕着这个框架去探索,学习别人是如何解决权限管理问题的。
github传送门
使用方式
1. 使用下面的一种方式去获取需要的权限
PermissionGen.with(MainActivity.this)
.addRequestCode(100)
.permissions(
Manifest.permission.READ_CONTACTS,
Manifest.permission.RECEIVE_SMS,
Manifest.permission.WRITE_CONTACTS)
.request();
or
PermissionGen.needPermission(ContactFragment.this, 100,
new String[] {
Manifest.permission.READ_CONTACTS,
Manifest.permission.RECEIVE_SMS,
Manifest.permission.WRITE_CONTACTS
}
);
2.重写 onRequestPermissionsResult 方法
@Override public void onRequestPermissionsResult(int requestCode, String[] permissions,
int[] grantResults) {
PermissionGen.onRequestPermissionsResult(this, requestCode, permissions, grantResults);
}
3.回调
正确:
@PermissionSuccess(requestCode = 100)
public void doSomething(){
Toast.makeText(this, "Contact permission is granted", Toast.LENGTH_SHORT).show();
}
错误:
@PermissionFail(requestCode = 100)
public void doFailSomething(){
Toast.makeText(this, "Contact permission is not granted", t.LENGTH_SHORT).show();
}
往往一个框架,简单的使用方式,背后大多数是非常复杂的架构或者设计模式,这个架构的代码量以及难度不是非常大,配合源码食用更佳。
基本分析
成员变量
private String[] mPermissions;
private int mRequestCode;
private Object object;
构造方法
private PermissionGen(Object object) {
this.object = object;
}
with方法
很多开源库惯用的手法,既传入Activity or Fragment的方法,并且调用构造方法,我想这个大家应该不能理解。
public static PermissionGen with(Activity activity){
return new PermissionGen(activity);
}
public static PermissionGen with(Fragment fragment){
return new PermissionGen(fragment);
}
赋值
既然有了对象,接下来就是对对象的成员变量进行赋值了。
public PermissionGen permissions(String... permissions){
this.mPermissions = permissions;
return this;
}
public PermissionGen addRequestCode(int requestCode){
this.mRequestCode = requestCode;
return this;
}
上述几个流程是非常简单的,如果你经常拆轮子,对于这些手法已经见怪不怪了,接下来就说说他是如果通过注解反射来进行权限申请已经回调的吧。
核心分析
requestResult
在使用方式的第二步调用了 PermissionGen.onRequestPermissionsResult(this, requestCode, permissions, grantResults); ,这是一个重载的方法,主要是第一个参数会不同,this可以是指向的对象可以是Fragment or Activity,但是最终都回调到一个方法。
public static void onRequestPermissionsResult(Activity activity, int requestCode, String[] permissions,int[] grantResults) {
requestResult(activity, requestCode, permissions, grantResults);
}
public static void onRequestPermissionsResult(Fragment fragment, int requestCode, String[] permissions,int[] grantResults) {
requestResult(fragment, 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);
}
}
使用注解的方式回调
正确时的回调的放阿飞
private static void doExecuteFail(Object activity, int requestCode) {
Method executeMethod = Utils.findMethodWithRequestCode(activity.getClass(),PermissionFail.class, requestCode);
executeMethod(activity, executeMethod);
}
方法一:
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;
}
方法二:
通过反射我们拿到了需要的方法,接下来就是运行这个方法了
private static void executeMethod(Object activity, Method executeMethod) {
if(executeMethod != null){
try {
if(!executeMethod.isAccessible()) executeMethod.setAccessible(true);
executeMethod.invoke(activity, null);
} catch (IllegalAccessException e) {
e.printStackTrace();
} catch (InvocationTargetException e) {
e.printStackTrace();
}
}
}
是不是非常简单,简单明了的几步流程,然后我们再睡觉描一眼 PermisstionSuccess 与 PermisstionFail 两个类
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface PermissionFail {
int requestCode();
}
与
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface PermissionSuccess {
int requestCode();
}
无非就是两个运行注解,参数为 int 类型。到这里 PermisstionGen框架解说完毕,接下来我们再来聊聊鸿神的框架。 github传送门
MPermissions
思路无非大同小异,最大的后者使用了编译注解,这个特点非常多的开源框架会选择使用,基于这点,就不存在反射损失效率的问题了。
使用方式
所有 Permisstion 相关的框架使用方式都是相同的,无非就是需要的权限,onRequestPermissionsResult 中去调用静态方法,最后回调,所以这里就不copy别人的代码来凑字数了,我们直接切入主题吧。
分析
依赖
因为使用了编译时注解,所以就会有依赖关系。
permission-sample 依赖 permission-api(也就是lib)
permission-lib 依赖 permission-annotation
compile 依赖 permission-annotation
注解类
在 permission-annotation 下有三个注解类
授权成功 PermissionGrant
@Target(ElementType.METHOD)
public @interface PermissionGrant{
int value();
}
授权失败 PermissionDenied
@Target(ElementType.METHOD)
public @interface PermissionDenied {
int value();
}
如果拒接了就提醒
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.CLASS)
public @interface ShowRequestPermissionRationale {
int value();
}
完成了上个注解处理器,接下来就是给 permission-lib 添加依赖,添加依赖后,我们来看看 permission-lib 中的主类。 【注:考虑到compile没做解说,因为有点复杂,后面我后另开一篇文章详细说明编译注解】
requestPermissions
和上一个框架非常类似的方法,但是直接抛弃了链式编程,直接把3个参数一坨放进去了。
public static void requestPermissions(Activity object, int requestCode, String... permissions){
_requestPermissions(object, requestCode, permissions);
}
public static void requestPermissions(Fragment object, int requestCode, String... permissions){
_requestPermissions(object, requestCode, permissions);
}
同样属于重载,来区分Activity与Fragment,最后调用下面的方法。
private static void _requestPermissions(Object object, int requestCode, String... permissions){
if (!Utils.isOverMarshmallow()){
doExecuteSuccess(object, requestCode);
return;
}
List<String> deniedPermissions = Utils.findDeniedPermissions(Utils.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);
}
}
代码无非是几个判断,就不做过多的解释,但是这里要和大家说点题外话,在外人看人,都是程序员,大家都能实现一个功能(任务),但是优秀的程序员会对代码逻辑判断做更多的处理。
去申请权限之后,当然就要在Activity中去重写这个方法 ,同样是最后去调用 onRequestPermissionsResult 。然后走到 MPermissions.requestResult 这个方法,接着就是 回调。 这里就概括下,因为与上个框架差不多。
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);
}
}
doExecuteFail 与 doExecuteSuccess
回调成功失败与否,框架是不会在乎的,他们只会通过得到的对象强转,然后去调用。
private static void doExecuteSuccess(Object activity, int requestCode){
findPermissionProxy(activity).grant(activity, requestCode);
}
private static void doExecuteFail(Object activity, int requestCode){
findPermissionProxy(activity).denied(activity, requestCode);
}
findPermissionProxy
private static PermissionProxy findPermissionProxy(Object activity)
{
try
{
Class clazz = activity.getClass();
Class injectorClazz = Class.forName(clazz.getName() + SUFFIX);
return (PermissionProxy) injectorClazz.newInstance();
} catch (ClassNotFoundException e)
{
e.printStackTrace();
} catch (InstantiationException e)
{
e.printStackTrace();
} catch (IllegalAccessException e)
{
e.printStackTrace();
}
throw new RuntimeException(String.format("can not find %s , something when compiler.", activity.getClass().getSimpleName() + SUFFIX));
}
与
public interface PermissionProxy<T>
{
void grant(T source, int requestCode);
void denied(T source, int requestCode);
void rationale(T source, int requestCode);
boolean needShowRationale(int requestCode);
}
h2>尾声
就这样,我们已经写好两个的框架的源码分析(因为很多关于权限管理的博客),解决以及封装思路大同小异,在项目中我们可以主动去使用它们的框架,当然,如果你有一种莫名其妙的激情你也可以自己封装一个简化版的。
同时,提醒大家多去拆别人的轮子,慢慢的,你的功力就会提升了。