Flutter Permission Handler 在 Android 上的权限请求最佳实践

背景介绍

Flutter Permission Handler 是 Flutter 生态中广泛使用的权限管理插件。在 Android 平台上，随着系统版本的迭代，权限模型也在不断变化，这给开发者带来了不少困惑。特别是在处理存储和媒体文件访问权限时，Android 11（API 30）和 Android 13（API 33）之间存在显著差异。

常见问题分析

许多开发者在使用 Flutter Permission Handler 时会遇到类似的问题：在 Android 11 设备上请求照片权限时，日志中会出现"没有在清单中找到权限"的警告信息。这通常是因为开发者错误地在 Android 11 设备上请求了仅适用于 Android 13 及更高版本的权限。

权限模型演变

Android 的存储权限模型经历了多次变化：

1. Android 10 及以下：使用简单的 READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 权限
2. Android 11-12：引入了更严格的存储访问限制
3. Android 13+：将媒体访问权限细分为 READ_MEDIA_IMAGES、READ_MEDIA_VIDEO 和 READ_MEDIA_AUDIO

正确实现方案

为了兼容不同 Android 版本，开发者需要实现版本感知的权限请求逻辑：

Future<PermissionStatus> requestPhotoPermission() async {
  final androidInfo = await DeviceInfoPlugin().androidInfo;
  Permission permissionToRequest;
  
  if (androidInfo.version.sdkInt <= 32) {
    permissionToRequest = Permission.storage;
  } else {
    permissionToRequest = Permission.photos;
  }
 
  if (await permissionToRequest.status.isDenied) {
    return await permissionToRequest.request();
  }
  return await permissionToRequest.status;
}

AndroidManifest 配置

在 AndroidManifest.xml 中，需要同时声明新旧两种权限：

<!-- 适用于 Android 11 及以下版本的存储权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />

<!-- 适用于 Android 13+ 的媒体权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />

最佳实践建议

1. 版本检查：始终检查设备运行的 Android 版本，请求适当的权限
2. 优雅降级：当用户拒绝权限时，提供清晰的解释和引导
3. 权限组合：根据应用功能需求，可能需要同时请求多个相关权限
4. 测试覆盖：确保在多个 Android 版本上进行充分测试

常见误区

1. 错误地使用 photos 权限：在 Android 11 设备上请求 photos 权限会导致失败
2. 遗漏 maxSdkVersion：没有为旧权限设置 maxSdkVersion 可能导致审核问题
3. 过度请求权限：只在真正需要时才请求权限，避免频繁打扰用户

通过遵循这些指导原则，开发者可以构建出更加健壮和用户友好的权限管理系统，确保应用在各种 Android 版本上都能正常工作。