Android EasyPermissions官方库，高效处理权限

梦里梦外; 2022-06-06 14:21 187阅读 0赞

Android M 权限相关教程：

*  [Android6.0权限处理篇][Android6.0]

--------------------

**介绍**：

> easypermission库是一个简化基本的系统权限逻辑的库，可用于在Android M或者更高版本上。

### **导入EasyPermissions依赖库**： ###

在Module的build.gradle中添加以下代码。

dependencies { compile 'pub.devrel:easypermissions:1.0.1' }

依赖库配置完成后，开始使用。

### **使用步骤** ###

#### **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。
 *  第四个参数 : 一些系列的权限。

![这里写图片描述][SouthEast]

#### **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()响应。

**运行效果，如下**：

![这里写图片描述][SouthEast 1]

#### **项目代码：[https://github.com/13767004362/EasyPermissionDemo][https_github.com_13767004362_EasyPermissionDemo]** ####

--------------------

**资源参考**：

*  easypermissions：[https://github.com/googlesamples/easypermissions][https_github.com_googlesamples_easypermissions]
 *  Android6.0权限处理篇：[http://blog.csdn.net/hexingen/article/details/53047236][Android6.0]

[Android6.0]: http://blog.csdn.net/hexingen/article/details/53047236
[SouthEast]: /images/20220606/7bb312973192429da1ae2036c32d9f73.png
[SouthEast 1]: /images/20220606/bf09e7fd044b4fd2b3dd627a8818b5bc.png
[https_github.com_13767004362_EasyPermissionDemo]: https://github.com/13767004362/EasyPermissionDemo
[https_github.com_googlesamples_easypermissions]: https://github.com/googlesamples/easypermissions