PermissionsDispatcher项目：Java中优雅处理Android运行时权限-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00568/article/details/148394060

PermissionsDispatcher项目：Java中优雅处理Android运行时权限

PermissionsDispatcher A declarative API to handle Android runtime permissions. 项目地址: https://gitcode.com/gh_mirrors/per/PermissionsDispatcher

前言

在Android开发中，运行时权限管理一直是开发者需要面对的挑战。传统的权限请求方式需要编写大量样板代码，容易出错且难以维护。PermissionsDispatcher项目通过注解处理器的方式，为开发者提供了一种简洁、类型安全的权限管理解决方案。本文将详细介绍如何在Java项目中使用PermissionsDispatcher来简化权限处理流程。

准备工作

1. 添加权限声明

在开始使用PermissionsDispatcher之前，首先需要在AndroidManifest.xml文件中声明所需的权限。例如，如果需要相机权限，应添加：

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

这是Android权限系统的基本要求，无论使用何种权限管理方式都必须先声明。

核心注解详解

PermissionsDispatcher的核心在于几个简洁明了的注解，它们共同构成了权限处理的完整流程：

@RuntimePermissions

必须使用，标记在Activity或Fragment类上，表示该类需要进行权限处理。编译器会根据这个注解生成辅助类。

@NeedsPermission

必须使用，标记在需要权限才能执行的方法上。可以指定一个或多个权限，当这些权限被授予时，该方法才会被执行。

@OnShowRationale

可选注解，用于向用户解释为什么需要这些权限。当用户第一次拒绝权限时，可以在这里展示说明对话框。

@OnPermissionDenied

可选注解，当用户拒绝权限请求时调用的方法。

@OnNeverAskAgain

可选注解，当用户选择"不再询问"并拒绝权限时调用的方法。

完整示例解析

让我们通过一个完整的相机权限示例来理解这些注解的实际应用：

@RuntimePermissions
public class MainActivity extends AppCompatActivity {

    // 需要相机权限的方法
    @NeedsPermission(Manifest.permission.CAMERA)
    void showCamera() {
        // 权限已授予，执行相机相关操作
        getSupportFragmentManager().beginTransaction()
                .replace(R.id.sample_content_fragment, CameraPreviewFragment.newInstance())
                .addToBackStack("camera")
                .commitAllowingStateLoss();
    }

    // 解释为什么需要相机权限
    @OnShowRationale(Manifest.permission.CAMERA)
    void showRationaleForCamera(final PermissionRequest request) {
        new AlertDialog.Builder(this)
            .setMessage(R.string.permission_camera_rationale)
            .setPositiveButton(R.string.button_allow, (dialog, button) -> request.proceed())
            .setNegativeButton(R.string.button_deny, (dialog, button) -> request.cancel())
            .show();
    }

    // 权限被拒绝时的处理
    @OnPermissionDenied(Manifest.permission.CAMERA)
    void showDeniedForCamera() {
        Toast.makeText(this, R.string.permission_camera_denied, Toast.LENGTH_SHORT).show();
    }

    // 用户选择"不再询问"时的处理
    @OnNeverAskAgain(Manifest.permission.CAMERA)
    void showNeverAskForCamera() {
        Toast.makeText(this, R.string.permission_camera_neverask, Toast.LENGTH_SHORT).show();
    }
}

生成的辅助类使用

编译后，PermissionsDispatcher会生成一个名为MainActivityPermissionsDispatcher的辅助类（格式为[Activity名] + PermissionsDispatcher）。我们需要做两件事来使用它：

权限检查：通过调用生成的xxxWithPermissionCheck方法来触发权限检查流程
处理回调：在onRequestPermissionsResult中委托给生成的辅助类处理

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    findViewById(R.id.button_camera).setOnClickListener(v -> {
        // 委托给生成的权限检查方法
        MainActivityPermissionsDispatcher.showCameraWithPermissionCheck(this);
    });
}

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    // 委托给生成的权限结果处理方法
    MainActivityPermissionsDispatcher.onRequestPermissionsResult(this, requestCode, grantResults);
}