1、介绍:
This library allows the usage of RxJava with the new Android M permission model.
即: 这个库支持RxJava与新的Android M版本权限模型一起使用。
2、如何依赖
2.1 简单使用(不支持RxJava,订阅)
``` compile 'com.tbruyelle.rxpermissions:rxpermissions:0.9.4@aar' ```
2.2支持RxJava的使用(将rxpermissions包名换为rxpermissions2) 即:
compile 'com.tbruyelle.rxpermissions2:rxpermissions:0.9.4@aar'
3、迁移到0.9 后的说明
官网介绍:
Version 0.9 now uses a retained fragment to trigger the permission request from the framework. As a result, the RxPermissions class is no more a singleton. To migrate from 0.8 or earlier, just replace the following :
即:
版本0.9现在使用支持Fragment去触发框架的权限请求。 因此,RxPermissions类不再功能单一。 要从0.8或更低版本迁移,只需更换以下内容:
RxPermissions.getInstance(this) -> new RxPermissions(this) // where this is an Activity instance
4、如何在项目中使用
在初始化Activity中加入如下代码:
RxPermissions rxPermissions=new RxPermissions(this);
rxPermissions.request(Manifest.permission.READ_EXTERNAL_STORAGE,Manifest.permission.CALL_PHONE,Manifest.permission.INTERNET).subscribe(new Consumer<Boolean>() {
@Override
public void accept(Boolean aBoolean) throws Exception {
if (aBoolean){
//申请的权限全部允许
Toast.makeText(MainActivity.this, "允许了权限!", Toast.LENGTH_SHORT).show();
initData();
}else{
//只要有一个权限被拒绝,就会执行
Toast.makeText(MainActivity.this, "未授权权限,部分功能不能使用", Toast.LENGTH_SHORT).show();
}
}
});
If you need to trigger the permission request from a specific event, you need to setup your event as an observable inside an initialization phase.
即:
如果您需要触发特定事件的权限请求,则需要在初始化阶段将事件设置为可观察的事件。
You can use JakeWharton/RxBinding to turn your view to an observable (not included in the library).
译:
您可以使用JakeWharton / RxBinding将您的视图转换为可观察对象(不包含在库中)。
例如:
// Must be done during an initialization phase like onCreate
RxView.clicks(findViewById(R.id.enableCamera))
.compose(rxPermissions.ensure(Manifest.permission.CAMERA))
.subscribe(granted -> {
// R.id.enableCamera has been clicked
});
同时申请多个权限:
rxPermissions
.request(Manifest.permission.CAMERA,
Manifest.permission.READ_PHONE_STATE)
.subscribe(granted -> {
if (granted) {
// All requested permissions are granted
} else {
// At least one permission is denied
}
});
监听具体的某一些权限是否进行了授权
rxPermissions
.requestEach(Manifest.permission.CAMERA,
Manifest.permission.READ_PHONE_STATE)
.subscribe(permission -> { // will emit 2 Permission objects
if (permission.granted) {
// `permission.name` is granted !
} else if (permission.shouldShowRequestPermissionRationale) {
// Denied permission without ask never again
} else {
// Denied permission with ask never again
// Need to go to the settings
}
});
5、状态
This library is still beta, so contributions are welcome. I'm currently using it in production since months without issue.
译:
这个库仍然是测试版,所以贡献是值得欢迎的。 目前我正在使用它在生产中没有问题。
6、优点:
避免担心框架版本。 如果sdk是前M,观察者将自动收到一个授予的结果。
防止您在权限请求和结果处理之间分割您的代码。 假如没有这个库,你必须在一个地方请求权限,并在Activity.onRequestPermissionsResult()中处理结果。
所有RX提供的有关转换,过滤,链接...
7、如果要使用订阅、观察,必须依赖rxjava库如:
// RxJava
compile 'io.reactivex.rxjava2:rxjava:2.0.1'
compile 'io.reactivex.rxjava2:rxandroid:2.0.1'
compile 'com.jakewharton.rxbinding2:rxbinding:2.0.0'
//rxpermissions
compile 'com.tbruyelle.rxpermissions2:rxpermissions:0.9.4@aar'
最后:附上RxPermissions的库github地址: https://github.com/tbruyelle/RxPermissions