FcPermissions:也许是目前最好的动态权限请求库

阅读 2042
收藏 192
2016-09-02
原文链接:blog.csdn.net

前言

以前做项目的时候做过一些关于Android M上权限处理的工作,当时就觉得这件事情还是有一些繁琐,于是当时就有做一个库出来解决这个问题的打算,但是后来又陆陆续续的发生了一些别的事,这个想法便搁置了。最近有点时间,便又开始了这个库的编写,至今终于有了些轮廓了。

项目地址:FcPermissions
欢迎大家前去点star或是拍砖提issue,来者不拒。

正文

1,效果展示

我用这个库做了一个小demo,下面是它运行时的GIF图:

效果展示

2,引入依赖

这个库是放在JitPack上的,依赖的方式也就是它的套路:

 allprojects {
        repositories {
            jcenter()
            maven { url "https://jitpack.io" }
        }
   }
dependencies {
        compile 'com.github.lypeer:FcPermissions:v0.0.1'
   }

很简单,就不赘叙了。

3,使用

FcPermissions提供了三种方法来进行权限的请求,分别是实现接口,继承抽象类,以及构建builder。接下来我将分别叙述这三种方式的操作步骤。

3.1,实现接口

框架中提供了一个 FcPermissionsCallbacks 接口,可直接在需要请求权限的 Activity 或 Fragment 中 implement 它。该接口有两个方法需要实现,分别是:

  • void onPermissionsGranted(int requestCode, List perms):当申请的权限被同意之后会调用这个方法,requestCode为请求码,perms为申请同意的权限列表。
  • void onPermissionsDenied(int requestCode, List perms):当申请的权限被拒绝之后会调用这个方法,requestCode为请求码,perms为被拒绝的权限列表。

值得注意的是,通过此种方法请求权限时,需要在onPermissionsDenied() 方法中调用 FcPermissions.checkDeniedPermissionsNeverAskAgain(),以处理用户点击“不再询问”之后的情况:

@Override
public void onPermissionsDenied(int requestCode, List perms) {
    Toast.makeText(this, R.string.prompt_been_denied, Toast.LENGTH_LONG).show();
    FcPermissions.checkDeniedPermissionsNeverAskAgain(this,
            getString(R.string.prompt_we_need_camera),
            R.string.setting, R.string.cancel, null, perms);
}

另外,通过此种方式请求权限时,需要重写 Actiivty/Fragment 的 onRequestPermissionsResult() 方法,将其参数传入 FcPermissions 处理:

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    FcPermissions.onRequestPermissionsResult(requestCode , permissions , grantResults , this);
}

在需要请求某个权限是,可调用 FcPermissions.requestPermissions() 方法,具体参数信息详见代码中的注释。

使用这种方式请求权限的 demo 代码详见 MainActivity.java

3.2,继承抽象类

大家可能已经发现了,在使用上一种方式请求权限的时候,需要我们做的事情还是略多了一点,于是在上一种方式的基础上我又进行了一些封装,力求让使用者尽可能的方便。

抽象类一共有三个,分别是:

  • FcPermissionsActivity :继承自 AppCompatActivity 。
  • FcPermissionsFragment:继承自 android.support.v4.app.Fragment 。
  • FcPermissionsAppFragment:继承自 android.app.Fragment 。

大家可以根据需要继承自不同的类,来完成请求权限的操作。他们全都是抽象类,继承他们需要 override 三个方法,分别是:

  • void onPermissionsGranted(int requestCode, List perms):当申请的权限被同意之后会调用这个方法,requestCode为请求码,perms为申请同意的权限列表。
  • void onPermissionDenied(int requestCode, List perms):当申请的权限被拒绝之后会调用这个方法,requestCode为请求码,perms为被拒绝的权限列表。
  • String getRationale4NeverAskAgain() :该方法的返回值为当用户拒绝提供权限并且选择不再提示之后的弹框提示内容。此方法必须重写并返回一个合法的String值。

之后只需要在需要请求权限的地方调用 requestPermissions() 方法即可(注意:此处的方法已经在抽象类中进行了封装,所以不需要再调用 FcPermissions )。

可以看到,这种方式需要开发者做的事情比较少,但是相对应的,通过继承的方式有可能会破坏原本项目的体系结构,所以如何取舍就要看大家自己的了。使用这种方式请求权限的 demo 代码详见 MainBaseActivity.java

3.3,构建Builder

除了上两种方式,框架还提供了一种方式,通过构建 Builder 来进行权限的请求,但要注意的是,这种方式的核心类是 FcPermissionsB , 而不是前面的 FcPemissions 类。

首先和第一种方式一致的是,需要在请求权限所在的 Activity/Fragment 中重写 onRequestPermissionsResult() 方法,将其参数传入 FcPermissionsB 处理:

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    mFcPermissionsB.onRequestPermissionsResult(requestCode , permissions , grantResults , this);
}

然后就可以开始构建 Builder 并开始请求了:

private void requestCameraPermission() {
    mFcPermissionsB = new FcPermissionsB.Builder(this)
            .onGrantedListener(new OnPermissionsGrantedListener() {
        @Override
        public void onPermissionsGranted(int requestCode, List perms) {

        }
    })
            .onDeniedListener(new OnPermissionsDeniedListener() {
        @Override
        public void onPermissionsDenied(int requestCode, List perms) {

        }
    })
            .positiveBtn4ReqPer(android.R.string.ok)
            .negativeBtn4ReqPer(R.string.cancel)
            .positiveBtn4NeverAskAgain(R.string.setting)
            .negativeBtn4NeverAskAgain(R.string.cancel)
            .rationale4ReqPer(getString(R.string.prompt_request_camara))
            .rationale4NeverAskAgain(getString(R.string.prompt_we_need_camera))
            .requestCode(RC_CAMERA)
            .build();
    mFcPermissionsB.requestPermissions(Manifest.permission.CAMERA);
}

builder里面必需的参数只有三个,分别是:

  • rationale4ReqPer() :询问是否前往请求权限的提示语。
  • rationale4NeverAskAgain() :询问在之前选择了”不再询问”之后是否选择去设置里修改权限的提示语。
  • requestCode() :请求码。

其他的builder的一些参数在这里就不多说了,基本上顾名思义也知道它是干啥的,不知道的话就去源码里看吧。使用这种方式请求权限的 demo 代码详见 MainBuilderActivity.java

结语

到这里基本上关于 FcPermissions 的用法的讲解就结束了,如果大家在使用过程中发现了什么问题的话欢迎给我提 issue 或者直接在评论区回复我。

最后,感谢 googlesample 的 easypermissions,库中参考了这个库的一些代码。

项目地址:FcPermissions
欢迎大家前去点star或是拍砖提issue,来者不拒。

评论