RxPermissions(基于RxJava2)

0. 背景
Android 6.0 (API level 23)中,将权限分成了两类。

  1. 一类是Install权限(称之为安装时权限
  2. 另一类是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的源码在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。
1
查看支持RxJava2的RxPermissions,将分支切换到2.x,如下:
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中使用权限

<!-- 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 sysshare.lq.com.rxpermissiontest;

import android.Manifest;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;

import com.tbruyelle.rxpermissions2.Permission;
import com.tbruyelle.rxpermissions2.RxPermissions;

import io.reactivex.functions.Consumer;

public class MainActivity extends AppCompatActivity {

    private static final String TAG = "RxPermissionTest";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        requestPermissions();
    }

    private void requestPermissions() {
        RxPermissions rxPermission = new RxPermissions(MainActivity.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
[图片上传中。。。(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.

如果访问被拒绝了
当第一次请求权限申请被拒绝后再进行第二次申请时,对话框中会多出一个 不再询问 的复选框。如果勾选了该复选框并且拒绝请求,那么以后将无法再申请该权限。也就是说在调用 requestPermissions() 后,onRequestPermissionsResult() 会立刻被调用并且申请结果为 PERMISSION_DENIED 。 其实这个时候还是有一根救命稻草的。

判断是否勾选不再询问

首先需要判断用户是否勾选了不再询问。

@Override

public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {

switch (requestCode){

case MY_PERMISSIONS_APPLY:

for (int i = 0; i < grantResults.length; i++) {

//判断权限的结果,如果有被拒绝,就return

if (grantResults[i] == PackageManager.PERMISSION_DENIED){

if (!ActivityCompat.shouldShowRequestPermissionRationale(this,

permissions[i])){

showToast("点击权限,并打开全部权限");

Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);

Uri uri = Uri.fromParts("package", getPackageName(), null);

intent.setData(uri);

startActivityForResult(intent, REQUEST_PERMISSION_SETTING);

}

ActivityCompat 位于 support.v7 包中,因为运行时权限是 6.0 的新特性,使用该类可以省略对版本的判断当权限申请被拒绝并且shouldShowRequestPermissionRationale() 返回 false 就表示勾选了不再询问。转到设置界面现在我们唯一能做的就是跳转到我们 App 的设置界面,让用户手动开启权限了。

也就是这几行代码,上面已经贴出,方便大家参考:

Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);

Uri uri = Uri.fromParts("package", getPackageName(), null);

intent.setData(uri);

startActivityForResult(intent, REQUEST_PERMISSION_SETTING);

·当然,你也可以先弹出对话框询问用户是否要授予权限,然后再跳转。

跳转到设置界面调用的是 startActivityForResult() 而不是 startActivity() 。

在 onActivityResult() 中没有必要对 resultCode 进行判断,因为用户只能通过返回键才能回到我们的 App 中,所以 resultCode 总是为 RESULT_CANCEL。

在 onActivityResult() 中还需要对权限进行判断,因为用户有可能没有授权就返回了!

使用RxPermissions(基于RxJava2)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,923评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,154评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,775评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,960评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,976评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,972评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,893评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,709评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,159评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,400评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,552评论 1 346
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,265评论 5 341
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,876评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,528评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,701评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,552评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,451评论 2 352

推荐阅读更多精彩内容