阿超 > AndPermission

AndPermission

2025-05-06

android

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

https://github.com/yanzhenjie/AndPermission

https://yanzhenjie.com/AndPermission

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

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

什么是 AndPermission？

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

核心特点：

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

使用场景

AndPermission 适用于以下场景：

  1. 动态权限请求
    处理运行时权限，如摄像头、存储、位置等。

  2. 权限组管理
    简化多个权限的统一管理和请求。

  3. 用户体验优化
    在权限被拒绝或永久拒绝时提供友好的提示。

快速上手指南

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

1. 添加依赖

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

1
implementation 'com.yanzhenjie:permission:2.0.3'

2. 请求权限

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

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

3. 跳转到设置页面

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

1
2
3
4
AndPermission.with(this)
    .runtime()
    .setting()
    .start(REQUEST_CODE);

高级功能

1. 权限分组

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

1
2
3
4
5
6
7
8
9
10
AndPermission.with(this)
    .runtime()
    .permission(Permission.Group.STORAGE)
    .onGranted(permissions -> {
        // 存储权限授予成功
    })
    .onDenied(permissions -> {
        // 存储权限被拒绝
    })
    .start();

2. 自定义回调逻辑

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
Action<List<String>> grantedAction = permissions -> {
    // 自定义权限授予逻辑
};

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

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

社区与支持

AndPermission 是一个活跃的开源项目，目前在 GitHub 上拥有 6639 个星标 和 1103 个分支，是 Android 开发者中广泛使用的权限管理库之一。你可以通过以下方式获取支持：

  • 访问项目主页：GitHub 仓库
  • 官方文档：AndPermission 文档
  • 提交 Issue：报告 Bug 或提出功能建议。
  • 贡献代码：通过 Pull Request 为项目做出贡献。

适用项目

AndPermission 适合各种类型的 Android 项目，尤其是在以下场景中表现出色：

  1. 社交应用：如需要访问相机、麦克风和存储权限。
  2. 地图和导航应用：需要高精度位置权限。
  3. 媒体播放器：需要存储和音视频录制权限。

结语

AndPermission 是一个功能强大且易于使用的 Android 权限管理库，通过其简洁的 API 和灵活的回调机制，帮助开发者快速实现权限管理。如果你正在寻找一个高效的权限管理解决方案，不妨试试 AndPermission！它将让你的开发过程更加轻松高效。