1.4 Android6.0权限管理-开源框架源码分析

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;
//保存Activity or Fragment
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);
}

赋值

既然有了对象,接下来就是对对象的成员变量进行赋值了。


//当然还有另外一种方式去添加 permissions 就是 needPermission 留个大家自己去思考咯
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()){
        //判断每个方法的注解是不是符合 annotation(PermissionSuccess or PermissionFail)
        if(method.isAnnotationPresent(annotation)){
            //最后调用了这个方法,就不copy了,非常简单,判断他的 requestCode 
            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();
        }
    }
}

是不是非常简单,简单明了的几步流程,然后我们再睡觉描一眼 PermisstionSuccessPermisstionFail 两个类


@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别人的代码来凑字数了,我们直接切入主题吧。

分析

依赖因为使用了编译时注解,所以就会有依赖关系。

20211123085458676633900

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>尾声

就这样,我们已经写好两个的框架的源码分析(因为很多关于权限管理的博客),解决以及封装思路大同小异,在项目中我们可以主动去使用它们的框架,当然,如果你有一种莫名其妙的激情你也可以自己封装一个简化版的。

同时,提醒大家多去拆别人的轮子,慢慢的,你的功力就会提升了。

20211123085459741463601

计算机