使用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.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使用的注意事项
參考 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:[email protected]‘
...
}
5.2 AndroidManifest.xml中使用权限
<!-- protection level is dangerous, need request runtime permission -->
<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<Permission>() {
@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.