Android-XXPermissions权限请求框架

图片来自网络

在日常的开发当中,肯定需要使用到一些Google官方定义的危险权限,这个时候就需要用到权限请求框架了,网上有很多开源的权限请求框架,我们可以避免重复造轮子,又可以节省我们的开发时间。分享一下我常用的XXPermissions权限请求框架。

导入依赖

implementation 'com.github.getActivity:XXPermissions:13.2'

13.2是我写博客时的最新版本。还需要在项目的build.gradle中加入下面语句:

buildscript {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

这样就是第一步导入依赖。

针对Android分区特性处理

我们就需要在AndroidManifest.xml中,加入下面的代码:

<manifest>
    <application>
        <!-- 表示当前项目已经适配了分区存储特性 -->
        <meta-data
            android:name="ScopedStorage"
            android:value="true" />
    </application>
</manifest>

链式请求权限代码

简单做一个权限请求的示例:

XXPermissions.with(this)
        // 申请单个权限
        .permission(Permission.RECORD_AUDIO)
        // 申请多个权限
        //.permission(Permission.Group.CALENDAR)
        // 申请安装包权限
        //.permission(Permission.REQUEST_INSTALL_PACKAGES)
        // 申请悬浮窗权限
        //.permission(Permission.SYSTEM_ALERT_WINDOW)
        // 申请通知栏权限
        //.permission(Permission.NOTIFICATION_SERVICE)
        // 申请系统设置权限
        //.permission(Permission.WRITE_SETTINGS)
        // 设置权限请求拦截器
        //.interceptor(new PermissionInterceptor())
        // 设置不触发错误检测机制
        //.unchecked()
        .request(new OnPermissionCallback() {

            @Override
            public void onGranted(List<String> permissions, boolean all) {
                if (all) {
                    toast("获取录音和日历权限成功");
                } else {
                    toast("获取部分权限成功,但部分权限未正常授予");
                }
            }

            @Override
            public void onDenied(List<String> permissions, boolean never) {
                if (never) {
                    toast("被永久拒绝授权,请手动授予录音和日历权限");
                    // 如果是被永久拒绝就跳转到应用权限系统设置页面
                    XXPermissions.startPermissionActivity(MainActivity.this, permissions);
                } else {
                    toast("获取录音和日历权限失败");
                }
            }
        });

这样动态申请高危的权限是不是很简单呢?我就喜欢这样去申请权限,方便快捷。

跳转到系统权限页面返回处理

可能前面的用户就是不肯给权限的情况,框架支持跳转到系统权限界面,从系统权限界面返回,我们可以这样处理:

public class XxxActivity extends AppCompatActivity {

    @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == XXPermissions.REQUEST_CODE) {
            if (XXPermissions.isGranted(this, Permission.RECORD_AUDIO) &&
                    XXPermissions.isGranted(this, Permission.Group.CALENDAR)) {
                toast("用户已经在权限设置页授予了录音和日历权限");
            } else {
                toast("用户没有在权限设置页授予权限");
            }
        }
    }
}

框架其他的API

上面说的是简单的事情,开源博主还提供了另外的API,也可以了解一下。
1.判断一个或多个权限是否全部授予了:

XXPermissions.isGranted(Context context, String... permissions);

2.获取没有授予的权限:

XXPermissions.getDenied(Context context, String... permissions);

3.判断某个权限是否为特殊权限:

XXPermissions.isSpecial(String permission);

4.判断一个或多个权限是否被永久拒绝了:

XXPermissions.isPermanentDenied(Activity activity, String... permissions);

5.跳转到应用权限设置页,可以传入三种不同的上下文:

XXPermissions.startPermissionActivity(Context context, String... permissions);
XXPermissions.startPermissionActivity(Activity activity, String... permissions);
XXPermissions.startPermissionActivity(Fragment fragment, String... permissions);

6.设置不触发错误检测机制(全局设置):

XXPermissions.setCheckMode(false);

7.设置权限申请拦截器(全局设置):

XXPermissions.setInterceptor(new IPermissionInterceptor() {});

本人使用这个开发框架的开发体验是非常的棒的,希望对看到的这篇文章的小伙伴有所帮助。

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容