AndPermission

阿超

发布于 2025-05-07 07:51:32

1053

文章被收录于专栏：快乐阿超快乐阿超

事业最要紧，名誉是空言。 —— 歌德

https://github.com/yanzhenjie/AndPermission

https://yanzhenjie.com/AndPermission

AndPermission：Android 平台的权限管理利器

在 Android 应用开发中，权限管理一直是一个复杂而重要的环节。自 Android 6.0 (API 23) 引入运行时权限以来，开发者需要动态处理用户授予的权限，以确保应用的正常运行。AndPermission 是一个开源的 Android 库，旨在简化权限管理的流程，为开发者提供高效、灵活的解决方案。

什么是 AndPermission？

AndPermission 是一个专注于 Android 平台的权限管理库，它通过简化权限请求和回调逻辑，让开发者能够专注于业务逻辑，而不必为权限处理的复杂性所困扰。

核心特点：

简洁的 API：提供易于理解和使用的权限请求接口。
权限分组：支持 Android 的权限分组特性，自动管理权限请求。
灵活的回调机制：轻松处理权限授予、拒绝和永久拒绝的情况。
链式调用：通过链式调用方式配置权限请求。
全面兼容：支持 Android 各版本的权限模型，兼容性强。

使用场景

AndPermission 适用于以下场景：

动态权限请求 处理运行时权限，如摄像头、存储、位置等。
权限组管理 简化多个权限的统一管理和请求。
用户体验优化 在权限被拒绝或永久拒绝时提供友好的提示。

快速上手指南

以下是使用 AndPermission 的基本步骤：

1. 添加依赖

在项目的 build.gradle 文件中添加以下依赖：

implementation 'com.yanzhenjie:permission:2.0.3'

2. 请求权限

通过简单的链式调用请求权限：

AndPermission.with(this)
    .runtime()
    .permission(Permission.CAMERA, Permission.WRITE_EXTERNAL_STORAGE)
    .onGranted(permissions -> {
        // 权限授予成功，执行相关操作
    })
    .onDenied(permissions -> {
        // 权限被拒绝
        if (AndPermission.hasAlwaysDeniedPermission(this, permissions)) {
            // 用户永久拒绝权限，建议跳转设置页面
        }
    })
    .start();

3. 跳转到设置页面

当用户永久拒绝权限时，可以引导用户通过设置页面授予权限：

AndPermission.with(this)
    .runtime()
    .setting()
    .start(REQUEST_CODE);

高级功能

1. 权限分组

AndPermission 支持 Android 的权限分组特性，可以一次性申请多个相关权限：

AndPermission.with(this)
    .runtime()
    .permission(Permission.Group.STORAGE)
    .onGranted(permissions -> {
        // 存储权限授予成功
    })
    .onDenied(permissions -> {
        // 存储权限被拒绝
    })
    .start();

2. 自定义回调逻辑

通过 Action 接口自定义权限授予和拒绝的行为：

Action<List<String>> grantedAction = permissions -> {
    // 自定义权限授予逻辑
};

Action<List<String>> deniedAction = permissions -> {
    // 自定义权限拒绝逻辑
};

AndPermission.with(this)
    .runtime()
    .permission(Permission.CAMERA)
    .onGranted(grantedAction)
    .onDenied(deniedAction)
    .start();