EasyPermission库是一个谷歌官方提供的简化基本的系统权限逻辑的库,可用于在Android M或者更高版本上。

官方项目地址:https://github.com/googlesamples/easypermissions

一、EasyPermission配置依赖

在需要使用此库的module的build.gradle中添加以下代码:

dependencies {
// For developers using AndroidX in their applications
   implementation 'pub.devrel:easypermissions:3.0.0' // For developers using the Android Support Library
implementation 'pub.devrel:easypermissions:2.0.1'
}

二、EasyPermission使用流程

1. 使用EasyPermissions检查权限:

权限可以是单个,也可以是一些列。在EasyPermission库中,使用EasyPermissions#hasPermissions(...)检查若干权限。

/**
*
* @param context
* return true:已经获取权限
* return false: 未获取权限,主动请求权限
*/ public static boolean checkPermission(Activity context,String[] perms) {
  return EasyPermissions.hasPermissions(context, perms);
}

EasyPermissions.hasPermissions():

第一个参数 : Context参数.例如,Activity对象。

第二个参数 : 一些系列的权限。例如,public final static String[] PERMS_WRITE ={Manifest.permission.WRITE_EXTERNAL_STORAGE};

2. 使用EasyPermissions请求权限:

检查后,发觉用户没有赋予权限,这时候需要代码请求权限,让用户同意。

在EasyPermission库中,使用EasyPermissions#requestPermissions,来请求权限。

/**
* 请求权限
* @param context
*/
public static void requestPermission(Activity context,String tip,int requestCode,String[] perms) {
  EasyPermissions.requestPermissions(context, tip,requestCode,perms);
}

EasyPermissions.requestPermissions():

第一个参数:Context对象
第二个参数:权限弹窗上的文字提示语。告诉用户,这个权限用途。
第三个参数:这次请求权限的唯一标示,code。
第四个参数 : 一些系列的权限。

3. EasyPermissions响应请求结果:

请求后,弹出系统权限弹窗,剩下是用户是否授权操作。权限结果是回调在Activity或者Fragment中的重写的onRequestPermissionsResult()方法中。

public class MainActivity extends AppCompatActivity implements EasyPermissions.PermissionCallbacks {

//.....省略部分代码。

/**
* 重写onRequestPermissionsResult,用于接受请求结果
*
* @param requestCode
* @param permissions
* @param grantResults
*/
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
  super.onRequestPermissionsResult(requestCode, permissions, grantResults);
  //将请求结果传递EasyPermission库处理
  EasyPermissions.onRequestPermissionsResult(requestCode, permissions, grantResults, this);
} /**
* 请求权限成功。
* 可以弹窗显示结果,也可执行具体需要的逻辑操作
*
* @param requestCode
* @param perms
*/
@Override
public void onPermissionsGranted(int requestCode, List<String> perms) {
  ToastUtils.showToast(getApplicationContext(), "用户授权成功");
}
/**
* 请求权限失败
*
* @param requestCode
* @param perms
*/
@Override
public void onPermissionsDenied(int requestCode, List<String> perms) {
  ToastUtils.showToast(getApplicationContext(), "用户授权失败");
  /**
  * 若是在权限弹窗中,用户勾选了'NEVER ASK AGAIN.'或者'不在提示',且拒绝权限。
  * 这时候,需要跳转到设置界面去,让用户手动开启。
  */
  if (EasyPermissions.somePermissionPermanentlyDenied(this, perms)) {
    new AppSettingsDialog.Builder(this).build().show();
  }
}
}

将权限结果传递给EasyPermissions.onRequestPermissionsResult()来处理。

EasyPermissions.onRequestPermissionsResult()方法:

第一个参数: 请求的code
第二个参数: 一些列的请求权限
第三个参数: 用户授权的结果
第四个参数: 权限回调监听器
这里不需要手写判断权限是否成功的逻辑操作,而会在EasyPermissions.PermissionCallbacks监听器中响应。

EasyPermissions.PermissionCallbacks接口:

  • onPermissionsGranted():用户授权成功,接下来执行具体需要的逻辑操作
  • onPermissionsDenied():用户授权失败,处理失败的逻辑。

注意:若是在权限弹窗中,用户勾选了’NEVER ASK AGAIN.’或者’不在提示’,且拒绝权限。 这时候,需要跳转到设置界面去,让用户手动开启。

你可能并不满足,需要手动调用逻辑处理方法。EasyPermissions库为你考虑好了,具备强大之处。当用户同意权限后,可以不需要通过监听器方式来实现,直接调用相关的逻辑代码的方法。只需要使用@AfterPermissionGranted注解标注逻辑处理的方法。

4. @AfterPermissionGranted注解:

@AfterPermissionGranted注解为了提供方便,但可以添加也可以不添加,是可选的。

好处:

使用了该注解,当权限请求被用户同意后,会根据请求code来执行,相应的含有@AfterPermissionGranted注解的方法。

简化了请求成功操作流程,不需要在EasyPermissions.onRequestPermissionsResult()的回调监听器中请求成功的方法中,再次手动调用,获取权限后需要操作的逻辑代码。

以下代码,请求写入磁盘的权限,当用户同意权限后,弹出一个Toast弹窗的逻辑处理操作。

@AfterPermissionGranted(Constance.WRITE_PERMISSION_CODE) // 可选的
public void onPermissionsSuccess() {
  ToastUtils.showToast(getApplicationContext(), "用户授权成功");
}

当用户同意权限,该方法不需要手动调用,会匹配到的Constance.WRITE_PERMISSION_CODE请求码,自动执行。

5. 使用EasyPermissions处理权限被拒的情况:

在权限弹窗中,用户可能直接拒绝权限,下次权限请求依旧会弹出该权限弹窗。除此之外,还可以勾选’NEVER ASK AGAIN.’或者’不在提示’,且拒绝权限,下次请求权限,弹窗不能弹出,无法让用户授权。这时候,需要跳转到设置界面去,让用户手动开启。

在EasyPermission库中,使用EasyPermissions.somePermissionPermanentlyDenied()来处理,是否勾选不再提示的选项。

/**
* 请求权限失败
*
* @param requestCode
* @param perms
*/
@Override
public void onPermissionsDenied(int requestCode, List<String> perms) {
  ToastUtils.showToast(getApplicationContext(), "用户授权失败");
  /**
  * 若是在权限弹窗中,用户勾选了'NEVER ASK AGAIN.'或者'不在提示',且拒绝权限。
  * 这时候,需要跳转到设置界面去,让用户手动开启。
  */
  if (EasyPermissions.somePermissionPermanentlyDenied(this, perms)) {
    new AppSettingsDialog.Builder(this).build().show();
  }
} @Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
  super.onActivityResult(requestCode, resultCode, data);
  switch (requestCode) {
  //当从软件设置界面,返回当前程序时候
  case AppSettingsDialog.DEFAULT_SETTINGS_REQ_CODE:
    //执行Toast显示或者其他逻辑处理操作
    break;
  }
}

以上代码是,当无法弹出权限弹框,直接跳转到设置界面去,让用户手动开启权限。

当从设置界面返回时候,结果会在Activity或者Fragment中onActivityResult()响应。

Android框架式编程之EasyPermissions的更多相关文章

  1. Android框架式编程之Android Architecture Components

    1. 当前Android开发面临的问题 Android开发不同于传统的桌面程序开发,桌面程序一般都有唯一的快捷方式入口,并且常作为单进程存在:而一个典型的Android应用通常由多个应用组件构成,包括 ...

  2. Android框架式编程之BufferKnife

    配置 compile 'com.jakewharton:butterknife:(insert latest version)' annotationProcessor 'com.jakewharto ...

  3. Android框架式编程之RxJava(一):HelloWorld

    Hello World 源码: import android.graphics.Bitmap; import android.graphics.BitmapFactory; import androi ...

  4. Android框架式编程之Room

    Room是Google官方出品的ORM(Object-relational mapping) 框架.当前我们也知道当前还有很多的ORM框架,例如GreenDao.OrmLite.Litepal等.目前 ...

  5. Android框架式编程之Retrofit

    一.Retrofit 简介 Retrofit 官网地址: https://github.com/square/retrofit Retrofit(即Retrofit,目前最新版本为2.6.0版本),是 ...

  6. Android框架式编程之Lifecycle

    Lifecycle官方文档地址:https://developer.android.com/topic/libraries/architecture/lifecycle. 一.为什么要使用Lifecy ...

  7. Android框架式编程之LiveData

    一.LiveData 介绍 LiveData是 Google 推荐的 Android 架构组件之一,是一个基于观察者模式的数据容器,但与一般的被观察者不同的是,它是有生命周期感知功能,解决了Andro ...

  8. Android框架式编程之EventBus

    一.EventBus 简介 EventBus是一种用于Android的事件发布-订阅总线,由GreenRobot开发,Gihub地址是:EventBus. 它简化了应用程序内各个组件之间进行通信的复杂 ...

  9. Android框架式编程之MVP架构

    MVP(Model-View-Presenter)模式.是将APP的结构分为三层:View - Presenter - Model. View 1. 提供UI交互 2. 在presenter的控制下修 ...

随机推荐

  1. Centos下安装X Window+GNOME Desktop+FreeNX

    FreeNX是近年来继VNC之后新出现的远程控制解决方案,基本原理是将XWindows的信号压缩后传输到远程客户端显示,而VNC是直接截取 屏幕图像处理传输.这样,在同样的传输信道条件下,FreeNX ...

  2. 国王游戏(codevs 1198)

    题目描述 恰逢 H 国国庆,国王邀请 n 位大臣来玩一个有奖游戏.首先,他让每个大臣在左.右手上面分别写下一个整数,国王自己也在左.右手上各写一个整数.然后,让这 n 位大臣排成一排,国王站在队伍的最 ...

  3. SOJ 3531_Number Pyramids

    [题意]给定一个数top及最底层元素个数n,构成一个以给top为塔尖,层数为n的如杨辉三角的金字塔,求有多少种 [分析]最终种数其实只与最底层的n个数的组合数有关,上层的每个都数是由最底层数相加得来 ...

  4. HDU——1150 Machine Schedule

    Machine Schedule Time Limit: 2000/1000 MS (Java/Others)    Memory Limit: 65536/32768 K (Java/Others) ...

  5. Servlet表单数据处理

    以下内容引用自http://wiki.jikexueyuan.com/project/servlet/form-data.html: 当需要从浏览器到Web服务器传递一些信息并最终传回到后台程序时,一 ...

  6. 015 WAN

    Router#config t Enter configuration commands, one per line.  End with CNTL/Z. Router(config)#int s0/ ...

  7. 003 rip

    r0#config t Enter configuration commands, one per line.  End with CNTL/Z. r0(config)#router rip r0(c ...

  8. Office 针式打印机如何调节边距

    1 右击针式打印机,选择"打印机属性"   2 点击"打印机参数设置"选项卡,之前打印出来如果发现上下距离不合适,可以通过调节但也纸页顶距来调整   该参数值可 ...

  9. echars入门篇

    官网地址:echars. 官方实例:首次使用请点击. 官方文档以及第一次操作实例如下 我们生活中有很多统计图,举例一下,有:柱形图.饼图.折线图等一些可以统计数据的形式. 图有:X轴(横轴),Y轴(纵 ...

  10. android application类简单介绍(一)

    每次应用程序执行时.应用程序的application类保持实例化的状态. 通过扩展applicaiton类,能够完毕下面3项工作: 1.对android执行时广播的应用程序级事件如低低内做出响应. 2 ...