使用RxPermissions(基于RxJava2)

使用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权限。

更多关于权限的说明,请参考:『Android 权限的一些细节』

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的源码在https://github.com/tbruyelle/RxPermissions。
其中master分支是支持RxJava 1.x的版本,包名为com.tbruyelle.rxpermissions2.x分支是支持RxJava2的版本,包名为com.tbruyelle.rxpermissions2
默认看到的是master分支,所以看到的代码是支持RxJava 1.x的RxPermissions。

分支的选择(如下图):
点击『Branch: master』之后,可以看到目前有3个分支:2.xfix46,和master

使用RxPermissions(基于RxJava2)_第1张图片

查看支持RxJava2的RxPermissions,将分支切换到2.x,如下:

使用RxPermissions(基于RxJava2)_第2张图片

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使用的注意事项

参考 https://github.com/tbruyelle/RxPermissions 中的README。

  • (1) minSdkVersion必须 >= 11。

  • (2) 使用RxPermissions申请权限,必须在Activity.onCreate()或者View.onFinishInflate()中处理。不能在onResume()中处理,因为onResume()在App的生命周期中可能执行的很频繁。如果在请求权限的时候,App重新启动了(例如屏幕旋转导致的App关闭再重新创建),那么用户的选择(允许 或者 拒绝)将无法发给App。 更多讨论,请参考:https://github.com/tbruyelle/RxPermissions/issues/69

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中使用权限

    
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    <uses-permission android:name="android.permission.READ_CALL_LOG"/>
    <uses-permission android:name="android.permission.RECORD_AUDIO"/>
    <uses-permission android:name="android.permission.CAMERA"/>
    <uses-permission android:name="android.permission.GET_ACCOUNTS"/>
    <uses-permission android:name="android.permission.READ_CONTACTS"/>
    <uses-permission android:name="android.permission.READ_CALENDAR"/>
    <uses-permission android:name="android.permission.SEND_SMS"/>
    <uses-permission android:name="android.permission.READ_SMS"/>
    <uses-permission android:name="android.permission.CALL_PHONE"/>

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.");
                        }
                    }
                });


    }
}

20180607 update: 相关代码已经放到 https://github.com/galian123/Samples , 包括了RxPermission在Activity中和Fragment中的使用。在fragment中使用,区别是,将new RxPermissions(RxPermissionTestActivity.this);改成new RxPermissions(getActivity());

5.4 界面显示及log

使用RxPermissions(基于RxJava2)_第3张图片

如果点击『拒绝』,不选中『不再询问』,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) https://github.com/tbruyelle/RxPermissions
  • (2)https://developer.android.com/guide/topics/permissions/requesting.html
  • (3) https://developer.android.com/training/permissions/requesting.html

你可能感兴趣的:(android,rxjava)