RxPermissions源码解析

项目地址：RxPermissions，本文分析版本: 4c4d4e1

1.简介

RxPermissions是基于RxJava开发的用于帮助在Android 6.0中处理运行时权限检测的框架。在Android 6.0中，系统新增了部分权限的运行时动态获取。而不再是在以前的版本中安装的时候授予权限。

对于运行时的权限获取提示，国内的Android工程师们应该并不陌生，国内的第三方ROM例如MIUI在很早前就做了类似的功能。但是第三方ROM并不能提供给我们权限请求成功或失败的接口,这就导致我们无法通过PackageManager提供的checkPermission()方法来准确的获取到我们是否获得该权限。只能根据具体的权限来做相应的处理。但是在Android 6.0中我们可以准确的获取我们的应用是否获取某个权限,具体的方法希望大家看这篇文章：Android 6.0 运行时权限处理。大致方法是通过API 23中的Activity的requestPermissions(String[] permissions, int requestCode);方法请求权限,并在onRequestPermissionsResult(int requestCode,String[] permissions,int[] grantResults)回调方法中处理请求结果。这个方法与onActivityResult()类似。RxPermissions在这个基础上做了封装,使我们在处理运行时权限变得更加的简单。

另外关于RxJava如果你现在还没了解过RxJava可以直接翻到文章最下面去查看我总结的一些RxJava相关的文章，不然并不推荐直接看这篇文章。下面我们就来具体看看RxPermissions的使用方法以及源码分析。

2.使用方法

1.直接获取权限(使用Retrolambda使代码更加简洁，当然并不是必须使用)：

// 必须在初始化阶段调用,例如onCreate()方法中
RxPermissions.getInstance(this)
    .request(Manifest.permission.CAMERA)
    .subscribe(granted -> {
        if (granted) { // 在android 6.0之前会默认返回true
           // 已经获取权限
        } else {
           // 未获取权限
        }
    });

2.通过条件触发获取权限(结合RxBinding使用)

// 必须在初始化阶段调用,例如onCreate()方法中
RxView.clicks(findViewById(R.id.enableCamera))
    .compose(RxPermissions.getInstance(this).ensure(Manifest.permission.CAMERA))
    .subscribe(granted -> {
        // 当R.id.enableCamera被点击的时候触发获取权限
    });

3.一次请求多个权限(有两种方式)

如果同时请求多个权限，下面这种方式会合并请求结果，即所有权限请求成功会返回true，若有一个权限未成功则返回false。

RxPermissions.getInstance(this)
    .request(Manifest.permission.CAMERA,
             Manifest.permission.READ_PHONE_STATE)
    .subscribe(granted -> {
        if (granted) {
           // 所有权限请求被同意
        } else {
           // 至少有一个权限没同意
        }
    });

当然你可以通过requestEach or ensureEach 来分别获取每一个权限请求的结果。

RxPermissions.getInstance(this)
    .requestEach(Manifest.permission.CAMERA,
             Manifest.permission.READ_PHONE_STATE)
    .subscribe(permission -> { // 会发送两个Permission对象
        if (permission.granted) {
           // `permission.name` is granted !
        }
    });

注意：由于在请求权限的过程中app有可能会被重启，所以权限请求必须放在初始化的阶段，比如在Activity.onCreate/onResume, 或者
View.onFinishInflate方法中。如果不这样处理，那么如果app在请求过程中重启的话，权限请求结果将不会发送给订阅者即subscriber。

2.整体介绍

RxPermission一共就只有三个类：Permission是定义的权限model类,用来存放权限名称以及是否获取权限的信息。RxPermissions就是最主要的类了，利用RxJava提供了我们上面在使用方法中介绍的所有方法。还有一个ShadowActivity类是用来请求权限用的。下面我们就来详细介绍RxPermission的实现。

注意：如果你还未了解过RxJava那么可以先阅读本文最后的一系列优秀文章。如果你已经了解过RxJava的话,那么下面我将会介绍RxJava中的部分操作符在RxPermission中的实际运用。相信能帮助你更好的理解RxJava中操作符的使用。

3.源码分析

我们依然按照我们惯用的方法来分析，通过使用方法来分析调用流程，最终理解整个项目。首先再回顾一遍使用方法(注意这里我同时请求了两个权限)，那么结果将是如果所有权限请求成功会返回true，若有一个权限未成功则返回false。代码如下：

// 必须在初始化阶段调用,例如onCreate()方法中
RxPermissions.getInstance(this)
    .request(Manifest.permission.CAMERA, Manifest.permission.WRITE_EXTERNAL_STORAGE)
    .subscribe(granted -> {
        if (granted) { // 在android 6.0之前会默认返回true
           // 已经获取权限
        } else {
           // 未获取权限
        }
    });

1.RxPermissions.getInstance(this)的实现

    static RxPermissions sSingleton;
    private Context ：;

    public static RxPermissions getInstance(Context) {
        if (sSingleton == null) {
            sSingleton = new RxPermissions(ctx.getApplicationContext());
        }
        return sSingleton;
    }

    RxPermissions(Context ctx) {
        mCtx = ctx;
    }

很明显是维护RxPermissions的单例，不再多做介绍，紧接着我们来看RxPermissions中request(Manifest.permission.CAMERA)方法的实现：

2.request(Manifest.permission.CAMERA, Manifest.permission.WRITE_EXTERNAL_STORAGE)的实现:

    public Observable request(final String... permissions) {
        return Observable.just(null).compose(ensure(permissions));
    }

首先从返回值看到是返回一个Observable对象，方法中也是直接return了Observable.just(null).compose(ensure(permissions))。这里涉及两个方法分别是just()以及compose()我们先解释这两个操作符：

1.Observable.just(null)

just操作符可以将某个对象转化为Observable对象，并且将其发射出去，可以是一个数字、一个字符串、数组、Iterate对象等，是RxJava中非常快捷的创建Observable对象的方法。在这里just()方法中虽然传入的是null但是并不影响创建出的Observable的作用,如果有subscriber订阅依然会依次调用其onNext()和onCompleted()方法。所以这里就是为了创建出一个Observable对象，便于后续的处理。创建完Observable对象之后紧接着调用了compose()方法：

2.compose(Transformer)操作符

compose()操作符是针对Observable自身的变换，通过我们自己定义的Transformer对象可以将对Observable对象变换的操作封装起来，实现一个简单的Transformer对象如下:

    class myTransformer implements Observable.Transformer {

        @Override
        public Observable call(Observable