AndPermission 技术文档

AndPermission 技术文档

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

1. 安装指南

1.1 环境要求

• Android 4.0 (API level 14) 及以上版本
• 仅支持 AndroidX

1.2 添加依赖

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

implementation 'com.yanzhenjie:permission:2.0.3'

1.3 同步项目

添加依赖后，点击 Sync Now 按钮，确保依赖库成功导入。

2. 项目使用说明

2.1 请求运行时权限

AndPermission 提供了简便的方式来请求运行时权限。以下是一个请求存储权限的示例：

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

2.2 分享私有文件

AndPermission 支持请求分享私有文件的权限。具体使用方法请参考项目文档。

2.3 请求安装未知来源的 APK

AndPermission 支持请求安装未知来源 APK 的权限。具体使用方法请参考项目文档。

2.4 请求在其他应用上绘制

AndPermission 支持请求在其他应用上绘制的权限。具体使用方法请参考项目文档。

2.5 请求显示通知

AndPermission 支持请求显示通知的权限。具体使用方法请参考项目文档。

2.6 请求访问通知

AndPermission 支持请求访问通知的权限。具体使用方法请参考项目文档。

2.7 请求修改系统设置

AndPermission 支持请求修改系统设置的权限。具体使用方法请参考项目文档。

3. 项目 API 使用文档

3.1 AndPermission.with(Context)

• 描述: 初始化 AndPermission 实例。
• 参数: Context 上下文对象。
• 返回值: AndPermission 实例。

3.2 runtime()

• 描述: 设置请求运行时权限。
• 返回值: Runtime 实例。

3.3 permission(Permission.Group)

• 描述: 设置请求的权限组。
• 参数: Permission.Group 权限组。
• 返回值: PermissionRequest 实例。

3.4 onGranted(List<String>)

• 描述: 权限被授予时的回调。
• 参数: List<String> 被授予的权限列表。
• 返回值: PermissionRequest 实例。

3.5 onDenied(List<String>)

• 描述: 权限被拒绝时的回调。
• 参数: List<String> 被拒绝的权限列表。
• 返回值: PermissionRequest 实例。

3.6 start()

• 描述: 开始请求权限。
• 返回值: 无。

4. 项目安装方式

4.1 通过 Gradle 安装

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

implementation 'com.yanzhenjie:permission:2.0.3'

4.2 通过 Maven 安装

在项目的 pom.xml 文件中添加以下依赖：

<dependency>
  <groupId>com.yanzhenjie</groupId>
  <artifactId>permission</artifactId>
  <version>2.0.3</version>
</dependency>

4.3 手动安装

可以从 GitHub 项目页面 下载源码，手动集成到项目中。

---

通过以上文档，您可以详细了解 AndPermission 项目的安装、使用及 API 调用方法。希望这篇文档能帮助您更好地使用 AndPermission 项目。

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