PermissionsDispatcher 使用教程

1. 项目的目录结构及介绍

PermissionsDispatcher 是一个用于处理 Android 运行时权限的开源库。以下是其主要目录结构和介绍：

PermissionsDispatcher/
├── app/
│   ├── build.gradle
│   └── src/
│       └── main/
│           ├── AndroidManifest.xml
│           └── java/
│               └── com/
│                   └── github/
│                       └── hotchemi/
│                           └── permissionsdispatcher/
│                               └── sample/
│                                   ├── MainActivity.java
│                                   └── MyFragment.java
├── permissionsdispatcher/
│   ├── build.gradle
│   └── src/
│       └── main/
│           ├── AndroidManifest.xml
│           └── java/
│               └── permissions/
│                   └── dispatcher/
│                       ├── PermissionsDispatcher.java
│                       └── annotations/
│                           ├── NeedsPermission.java
│                           ├── OnNeverAskAgain.java
│                           ├── OnPermissionDenied.java
│                           └── OnShowRationale.java
├── build.gradle
├── gradle.properties
├── settings.gradle
└── README.md

主要目录介绍：

• app/: 示例应用的目录，包含示例代码和配置文件。
• permissionsdispatcher/: 库的核心代码目录，包含注解和处理逻辑。
• build.gradle: 项目的构建脚本。
• gradle.properties: Gradle 配置属性文件。
• settings.gradle: 项目设置文件，包含子项目的配置。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

PermissionsDispatcher 的启动文件主要是示例应用中的 MainActivity.java。以下是其主要内容和介绍：

package com.github.hotchemi.permissionsdispatcher.sample;

import android.Manifest;
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import permissions.dispatcher.NeedsPermission;
import permissions.dispatcher.OnNeverAskAgain;
import permissions.dispatcher.OnPermissionDenied;
import permissions.dispatcher.OnShowRationale;
import permissions.dispatcher.PermissionRequest;
import permissions.dispatcher.RuntimePermissions;

@RuntimePermissions
public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        MainActivityPermissionsDispatcher.showCameraWithPermissionCheck(this);
    }

    @NeedsPermission(Manifest.permission.CAMERA)
    void showCamera() {
        // 处理相机权限逻辑
    }

    @OnShowRationale(Manifest.permission.CAMERA)
    void showRationaleForCamera(PermissionRequest request) {
        // 显示权限请求的解释
    }

    @OnPermissionDenied(Manifest.permission.CAMERA)
    void onCameraDenied() {
        // 处理权限被拒绝的逻辑
    }

    @OnNeverAskAgain(Manifest.permission.CAMERA)
    void onCameraNeverAskAgain() {
        // 处理用户选择“不再询问”的逻辑
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        MainActivityPermissionsDispatcher.onRequestPermissionsResult(this, requestCode, grantResults);
    }
}

主要功能介绍：

• @RuntimePermissions: 标记该类需要处理运行时权限。
• @NeedsPermission: 标记需要权限的方法。
• @OnShowRationale: 标记显示权限请求解释的方法。
• @OnPermissionDenied: 标记权限被拒绝时的处理方法。
• @OnNeverAskAgain: 标记用户选择“不再询问”时的处理方法。

3. 项目的配置文件介绍

PermissionsDispatcher 的配置文件主要包括 build.gradle 和 AndroidManifest.xml。

build.gradle

在项目的根目录和 app 目录下都有 build.gradle 文件，用于配置项目的构建脚本。以下是 app 目录下的 build.gradle 文件的主要内容：

apply plugin: 'com.android.application'
apply plugin: 'kotlin-android'
apply plugin: 'kotlin-kapt'

android {