AndPermission 开源项目指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00526/article/details/141009140

AndPermission 开源项目指南

AndPermission:strawberry: Permissions manager for Android platform.项目地址:https://gitcode.com/gh_mirrors/an/AndPermission

1. 项目介绍

AndPermission 是一款专门为安卓平台设计的权限管理框架，由 YanZhenJie 创建并维护，旨在简化应用程序中对各种运行时权限的请求过程。它支持包括但不限于相机、相册、位置服务在内的多种常见权限类型，同时也提供了处理特殊权限如覆盖绘制、显示通知和访问通知等功能。

该项目遵循 Apache-2.0 许可证，已在 GitHub 上公开托管，获得了广泛的关注和社区支持，有着超过六千颗星标以及一千多次fork记录。

主要特性

简洁性: 提供了一套简洁的API用于权限的申请和验证。
灵活性: 不仅适用于常见的运行时权限，还能扩展至更复杂场景中的权限管理。
易用性: 自带丰富的示例和文档，便于开发者快速上手。

2. 快速启动

为了开始使用 AndPermission，你需要在你的项目中添加相关依赖。首先，在 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'com.yanzhenjie:permission:2.0.2'
}

接下来，让我们来看一个简单的代码示例，展示如何使用 AndPermission 请求摄像头权限：

val permissions = arrayOf(
    Permission.CAMERA,
    Permission.READ_EXTERNAL_STORAGE,
    Permission.READ_PHONE_STATE
)

AndPermission.with(this)
    .runtime()
    .permission(*permissions)
    .onGranted {
        Log.e("TAG", "所有权限均已授权")
        // 在这里写入当权限被授予后的业务逻辑代码
    }
    .onDenied { denied ->
        // 处理部分或全部权限未被授予的情况
        if (denied.contains(Permission.READ_PHONE_STATE)) {
            Log.e("TAG", "电话状态读取权限被拒绝")
        }
    }
    .start()

3. 应用案例和最佳实践

示例：请求摄像头和存储权限

// 请求摄像头权限
AndPermission.with(this)
    .runtime()
    .permission(Permission.CAMERA)
    .onGranted {
        Toast.makeText(this, "已获得摄像头权限", Toast.LENGTH_SHORT).show()
    }
    .onDenied {
        Toast.makeText(this, "未获得摄像头权限", Toast.LENGTH_SHORT).show()
    }
    .start()

// 请求存储权限组
AndPermission.with(this)
    .runtime()
    .permission(Permission.Group.STORAGE)
    .onGranted {
        Toast.makeText(this, "已获得存储权限", Toast.LENGTH_SHORT).show()
    }
    .onDenied {
        Toast.makeText(this, "未获得存储权限", Toast.LENGTH_SHORT).show()
    }
    .start()