在移动应用开发中，权限管理是守护用户隐私的第一道防线，也是决定应用功能完整性的关键环节。今天我们将聚焦Flutter生态中的明星库permission_handler，手把手教你实现专业的权限管理方案，以相册权限为示例展示。

一、依赖库安装

flutter pub add permission_handler

二、权限状态解析

三、权限请求实战：Dart层代码

Future<void> getCurrentStatus() async {
  // 查询获取授权状态
  var status = await Permission.photos.status;
  if (status.isDenied) { // 未申请过
      // 请求权限
      PermissionStatus result = await Permission.photos.request();
      if (result.isGranted) {
        debugPrint("权限已授予");
      } else if (status.isPermanentlyDenied) { // 拒绝
        debugPrint("权限拒绝");
      } else {
        debugPrint("first status = $status");
      }
  } else if (status.isPermanentlyDenied) { // 拒绝
    // 引导用户手动开启
    openAppSettings();
  } else if (status.isGranted) { // 运行访问
    // 业务处理
    debugPrint("权限已授予");
  }
  else {
    debugPrint("status = $status");
  }
}

四、平台适配指南

iOS端关键配置

在Info.plist中添加权限描述

# 以相册权限为例
<key>NSPhotoLibraryUsageDescription</key>
<string>使用相册</string>

在Podfile末尾添加：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    
    # 从这里添加
    target.build_configurations.each do |config|
      config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
        '$(inherited)',
        'PERMISSION_PHOTOS=1',  # 按需启用具体权限（如相册）
      ]
    end
    
  end
end

Android端配置

在AndroidManifest.xml添加对应的权限

<!-- 适配 Android 13 以下 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<!-- 适配 Android 13+ -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

// 动态请求相册权限
Future<bool> requestGalleryPermission() async {
  // 根据 Android 版本选择权限类型
  if (Platform.isAndroid) {
    final androidInfo = await DeviceInfoPlugin().androidInfo;
    final sdkVersion = androidInfo.version.sdkInt;
    Permission permission;
    if (sdkVersion >= 33) {
      permission = Permission.photos; // Android 13+ 使用 READ_MEDIA_IMAGES
    } else {
      permission = Permission.storage; // Android 13 以下使用 READ_EXTERNAL_STORAGE
    }
    final status = await permission.request();
    debugPrint("status = $status");
    return status.isGranted;
  } else {
    // iOS 处理
  }
}

五、避坑指南

1. iOS审核必须：所有权限描述必须真实准确，违规将导致审核被拒
2. Android版本适配：注意API 33的分水岭变化
3. 动态请求原则：按需请求权限，避免启动时批量申请
4. 降级处理：当用户拒绝时提供替代方案（如手动选择文件）

后续文章优先在 WX公众号 “天天开发” 中发布，如有需要请搜索关注！