PermissionsDispatcher处理Android特殊权限详解

最新推荐文章于 2025-06-03 09:11:46 发布

田慧娉

最新推荐文章于 2025-06-03 09:11:46 发布

阅读量363

点赞数 5

本文链接：https://blog.csdn.net/gitblog_00785/article/details/148394073

版权

PermissionsDispatcher处理Android特殊权限详解

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

什么是特殊权限

在Android开发中，大多数运行时权限可以通过标准的权限请求流程处理，但有两类特殊权限需要特别注意：SYSTEM_ALERT_WINDOW（系统悬浮窗权限）和WRITE_SETTINGS（系统设置写入权限）。这些权限被称为特殊权限，因为它们的授权方式与常规权限不同。

PermissionsDispatcher作为一个简化Android运行时权限处理的库，也提供了对这些特殊权限的支持，使得开发者可以用统一的方式处理所有类型的权限请求。

特殊权限的特点

授权机制不同：特殊权限不是通过标准的权限对话框授权，而是需要跳转到系统设置页面由用户手动开启
检查方式不同：需要使用特殊的API来检查是否已授权
回调处理不同：授权结果通过onActivityResult回调返回，而不是标准的权限回调

使用PermissionsDispatcher处理SYSTEM_ALERT_WINDOW权限

下面我们以SYSTEM_ALERT_WINDOW权限为例，详细介绍如何使用PermissionsDispatcher处理特殊权限。

第一步：声明权限

在AndroidManifest.xml中添加权限声明：

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

第二步：添加注解

与处理普通权限类似，我们需要在Activity中添加相应的注解：

@RuntimePermissions
public class MainActivity extends AppCompatActivity {

    // 需要权限的方法
    @NeedsPermission(Manifest.permission.SYSTEM_ALERT_WINDOW)
    void systemAlertWindow() {
        // 权限获取成功后执行的操作
        Toast.makeText(this, "悬浮窗权限已授权", Toast.LENGTH_SHORT).show();
    }

    // 显示权限说明
    @OnShowRationale(Manifest.permission.SYSTEM_ALERT_WINDOW)
    void systemAlertWindowOnShowRationale(final PermissionRequest request) {
        new AlertDialog.Builder(this)
            .setMessage("需要悬浮窗权限来显示通知")
            .setPositiveButton("确定", (dialog, which) -> request.proceed())
            .setNegativeButton("取消", (dialog, which) -> request.cancel())
            .show();
    }

    // 权限被拒绝
    @OnPermissionDenied(Manifest.permission.SYSTEM_ALERT_WINDOW)
    void systemAlertWindowOnPermissionDenied() {
        Toast.makeText(this, "悬浮窗权限被拒绝", Toast.LENGTH_SHORT).show();
    }

    // 用户选择了"不再询问"
    @OnNeverAskAgain(Manifest.permission.SYSTEM_ALERT_WINDOW)
    void systemAlertWindowOnNeverAskAgain() {
        Toast.makeText(this, "您已选择不再询问此权限", Toast.LENGTH_SHORT).show();
    }
}

第三步：处理权限请求和回调

特殊权限的关键区别在于需要在onActivityResult中处理回调：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    
    // 绑定按钮点击事件
    findViewById(R.id.button_system_alert_window).setOnClickListener(v -> {
        // 通过生成的类处理权限请求
        MainActivityPermissionsDispatcher.systemAlertWindowWithPermissionCheck(this);
    });
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    // 必须将结果传递给PermissionsDispatcher处理
    MainActivityPermissionsDispatcher.onActivityResult(this, requestCode);
}

注意事项

权限检查：特殊权限的检查不能使用ContextCompat.checkSelfPermission()，而应该使用Settings.canDrawOverlays()等方法
用户引导：当用户拒绝权限时，应该提供清晰的引导，说明如何手动开启权限
兼容性：不同Android版本对特殊权限的处理可能有所不同，需要进行充分测试
权限必要性：特殊权限通常涉及系统级操作，应谨慎使用，确保应用确实需要这些权限