使用RxPermissions（基于RxJava2）

0. 背景

Android 6.0 （API level 23）中。将权限分成了两类。一类是Install权限（称之为安装时权限）。还有一类是Runtime权限（称之为执行时权限）。

• Install权限是什么？

  Install权限：安装时权限，顾名思义，是在安装app时。就赋予该app的权限，即安装后马上获取到的权限。normal和signature级别的权限都是安装时权限。赋予app normal和signature权限时，不会给用户提示界面，系统自己主动决定权限的赋予。对于signature权限，假设使用权限的app与声明权限的app的签名不一致，则系统拒绝赋予该signature权限。

• Runtime权限是什么？

  Runtime权限：执行时权限。是指在app执行过程中。赋予app的权限。这个过程中，会显示明显的权限授予界面，让用户决定是否授予权限。假设app的targetSdkVersion是22（Lollipop MR1）及下面，dangerous权限是安装时权限，否则dangerous权限是执行时权限。
  假设一个app的targetSdkVersion是23（或者23以上）。那么该app所申请的全部dangerous权限都是执行时权限。假设执行在Android 6.0的环境中，该app在执行时必须主动申请这些dangerous权限（调用requestPermissions()）。否则该app没有获取到dangerous权限。

很多其它关于权限的说明，请參考：

1. RxPermissions的优点

RxPermissions是帮助开发人员简化requestPermissions()相关的处理。

• （1） 开发人员不用操心Android执行环境的版本号。假设系统是Android 6.0之前的版本号，RxPermissions返回的结果是，app请求的每一个权限都被同意（granted）。
  RxPermissions内部已经对Android版本号进行了推断：

boolean isMarshmallow() {        return Build.VERSION.SDK_INT >= Build.VERSION_CODES.M;    }    public boolean isGranted(String permission) {        // 假设是Android 6.0 （Api 23）之前，则权限被同意使用。        return !isMarshmallow() || mRxPermissionsFragment.isGranted(permission);    }

• （2） 将权限申请的代码（requestPermissions()）和请求结果的代码（onRequestPermissionsResult()）放在一起管理，避免了代码的分散。

• （3） RxPermissions具备Rx（RxJava）的特性，比如能够使用链式操作，能够执行filter操作，transform操作。等等。

2. RxPermissions的版本号

RxPermissions是基于RxJava的，RxJava如今有2个大版本号。一个RxJava 1.x（通常说RxJava），还有一个是RxJava2。

所以RxPermissions有2个版本号，分别支持RxJava和RxJava2。

RxPermissions的源代码在。

当中master分支是支持RxJava 1.x的版本号，包名为com.tbruyelle.rxpermissions。2.x分支是支持RxJava2的版本号。包名为com.tbruyelle.rxpermissions2。

默认看到的是master分支，所以看到的代码是支持RxJava 1.x的RxPermissions。

分支的选择（例如以下图）：

点击『Branch: master』之后，能够看到眼下有3个分支：2.x，fix46,和master。

查看支持RxJava2的RxPermissions，将分支切换到2.x，例如以下：

3. RxPermissions代码下载

下载包名为com.tbruyelle.rxpermissions的代码（支持RxJava1.x）：

git clone https://github.com/tbruyelle/RxPermissions

下载包名为com.tbruyelle.rxpermissions2的代码（支持RxJava2）：

git clone https://github.com/tbruyelle/RxPermissions RxPermissions2 -b 2.x

4. RxPermissions使用的注意事项

參考 中的README。

• （1） minSdkVersion必须 >= 11。

• （2） 使用RxPermissions申请权限，必须在Activity.onCreate()或者View.onFinishInflate()中处理。

  不能在onResume()中处理。由于onResume()在App的生命周期中可能执行的非常频繁。假设在请求权限的时候。App又一次启动了（比如屏幕旋转导致的App关闭再又一次创建）。那么用户的选择（同意 或者 拒绝）将无法发给App。 很多其它讨论，请參考：

5. RxPermissions使用

基于RxJava2，使用包名为com.tbruyelle.rxpermissions2的RxPermissions。

5.1 App module的build.gradle

dependencies {    ...    compile 'io.reactivex.rxjava2:rxandroid:2.0.1'    compile 'io.reactivex.rxjava2:rxjava:2.0.5'    compile 'com.tbruyelle.rxpermissions2:rxpermissions:0.9.3@aar'    ...}

5.2 AndroidManifest.xml中使用权限

5.3 在Activity的onCreate()中申请权限

package com.galian.rxjavatest;import android.Manifest;import android.support.v7.app.AppCompatActivity;import android.os.Bundle;import android.util.Log;import com.tbruyelle.rxpermissions2.Permission;import com.tbruyelle.rxpermissions2.RxPermissions;import io.reactivex.functions.Consumer;public class RxPermissionTestActivity extends AppCompatActivity {
          private static final String TAG = "RxPermissionTest";    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_rx_permission_test);        requestPermissions();    }    private void requestPermissions() {        RxPermissions rxPermission = new RxPermissions(RxPermissionTestActivity.this);        rxPermission                .requestEach(Manifest.permission.ACCESS_FINE_LOCATION,                        Manifest.permission.WRITE_EXTERNAL_STORAGE,                        Manifest.permission.READ_CALENDAR,                        Manifest.permission.READ_CALL_LOG,                        Manifest.permission.READ_CONTACTS,                        Manifest.permission.READ_PHONE_STATE,                        Manifest.permission.READ_SMS,                        Manifest.permission.RECORD_AUDIO,                        Manifest.permission.CAMERA,                        Manifest.permission.CALL_PHONE,                        Manifest.permission.SEND_SMS)                .subscribe(new Consumer
      
       () {                    @Override                    public void accept(Permission permission) throws Exception {                        if (permission.granted) {                            // 用户已经同意该权限                            Log.d(TAG, permission.name + " is granted.");                        } else if (permission.shouldShowRequestPermissionRationale) {                            // 用户拒绝了该权限，没有选中『不再询问』（Never ask again）,那么下次再次启动时。还会提示请求权限的对话框                            Log.d(TAG, permission.name + " is denied. More info should be provided.");                        } else {                            // 用户拒绝了该权限，而且选中『不再询问』                            Log.d(TAG, permission.name + " is denied.");                        }                    }                });    }}
      

5.4 界面显示及log

假设点击『拒绝』。不选中『不再询问』，log为：

D/RxPermissionTest: android.permission.ACCESS_FINE_LOCATION is denied. More info should be provided.

假设点击『拒绝』，选中了『不再询问』。则log为：

D/RxPermissionTest: android.permission.ACCESS_FINE_LOCATION is denied.

假设点击『同意』，log为：

D/RxPermissionTest: android.permission.ACCESS_FINE_LOCATION is granted.

6. 參考

• （1）
• （2）
• （3）