【亲测免费】 权限调度器(PermissionsDispatcher)使用指南

1. 项目介绍

权限调度器(PermissionsDispatcher) 是一个用于简化Android运行时权限管理的库。它提供了声明式的API，使得开发者可以通过注解的方式来处理权限请求，从而让代码更清晰、更简洁。该项目由Shintaro Katafuchi、Marcel Schnelle、Yoshinori Isogai等人创建并维护，遵循Apache License Version 2.0。

2. 项目快速启动

2.1 添加依赖

首先，在你的build.gradle（app模块）文件中添加权限调度器的依赖项：

dependencies {
    implementation "org.permissionsdispatcher:permissionsdispatcher:$[latest_version]"
    annotationProcessor "org.permissionsdispatcher:permissionsdispatcher-processor:$[latest_version]"
}

如果你使用的是Kotlin，你需要启用Kapt插件：

apply plugin: 'kotlin-kapt'

2.2 准备AndroidManifest.xml

在AndroidManifest.xml中添加所需的权限声明，例如对于相机权限：

<uses-permission android:name="android.permission.CAMERA" />

2.3 使用注解

Kotlin 示例:

import android.Manifest
import androidx.appcompat.app.AppCompatActivity
import org.permissionsdispatcher.annotation.NeedsPermission
import org.permissionsdispatcher.annotation.OnShowRationale
import org.permissionsdispatcher.annotation.OnPermissionDenied
import org.permissionsdispatcher.annotation.PermissionRequest

@NeedsPermission(Manifest.permission.CAMERA)
fun useCamera() {
    // 在这里放置需要权限才能执行的代码
}

@OnShowRationale(Manifest.permission.CAMERA)
fun showRationaleForCamera(request: PermissionRequest) {
    // 用户被询问为什么需要此权限时显示的理由
    request.proceed() // 继续请求权限
}

@OnPermissionDenied(Manifest.permission.CAMERA)
fun cameraPermissionDenied() {
    // 用户拒绝权限时的处理逻辑
}

Java 示例:

import android.content.pm.PackageManager;
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import org.permissionsdispatcher.NeedsPermission;
import org.permissionsdispatcher.OnPermissionDenied;
import org.permissionsdispatcher.OnShowRationale;
import org.permissionsdispatcher.PermissionUtils;

public class MainActivity extends AppCompatActivity {

    @NeedsPermission(Manifest.permission.CAMERA)
    void useCamera() {
        // 在这里放置需要权限才能执行的代码
    }

    @OnShowRationale(Manifest.permission.CAMERA)
    void showRationaleForCamera(PermissionRequest request) {
        // 用户被询问为什么需要此权限时显示的理由
        request.proceed(); // 继续请求权限
    }

    @OnPermissionDenied(Manifest.permission.CAMERA)
    void cameraPermissionDenied() {
        // 用户拒绝权限时的处理逻辑
    }
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        if (checkSelfPermission(Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) {
            requestPermissions(new String[]{Manifest.permission.CAMERA}, 100);
        } else {
            useCamera();
        }
    }
}

3. 应用案例和最佳实践

• 异步请求: 可以利用PermissionUtil.execute()进行异步请求，避免阻塞主线程。
• 生命周期管理: 注意在Activity或Fragment的适当生命周期方法中处理权限请求的状态。
• 自定义对话框: 可以通过实现PermissionRequest接口自定义权限请求的展示方式。

4. 典型生态项目

• IntelliJ 插件: 提供IntelliJ IDEA集成，帮助检查和修复权限相关的问题。
• AndroidAnnotations 插件: 结合AndroidAnnotations库，进一步简化代码书写。
• 特殊权限支持: 支持如SYSTEM_ALERT_WINDOW等特殊权限的处理。

要获取最新版本及更多详细信息，请参考项目官方文档和示例代码：

• PermissionsDispatcher官方仓库

通过以上步骤，你应该能够顺利地将权限调度器集成进你的Android项目，有效地管理运行时权限。