Flutter开发Android应用：如何让pickImage仅显示图片及检查文件夹权限

一、限制仅选择图片（推荐方案） #

你当前使用的pickImage是image_picker包的旧版API，部分Android系统的文件选择器可能出现允许进入文件夹的情况。推荐使用新版pickMediaAPI，通过指定允许的媒体类型，强制仅显示图片文件：

final ImagePicker picker = ImagePicker();
final XFile? image = await picker.pickMedia(
  mediaOptions: const MediaOptions(
    allowedTypes: ['image'],
  ),
  imageQuality: 20,
);

该方法会明确告知系统文件选择器仅展示图片类型文件，从根源上避免出现文件夹选择入口。

二、检查文件夹权限（当上述方案无法满足时） #

从Android 10（API 29）开始，系统采用分区存储机制，访问媒体文件无需申请READ_EXTERNAL_STORAGE权限；但如果需要访问非媒体目录（如自定义文件夹），则需申请MANAGE_EXTERNAL_STORAGE权限（该权限需用户手动在系统设置中开启，无法通过常规弹窗请求）。

可使用permission_handler包检查权限状态：

1. 在pubspec.yaml中添加依赖：

dependencies:
  permission_handler: ^10.2.0

2. 权限检查代码示例：

import 'package:permission_handler/permission_handler.dart';

Future<void> checkStoragePermission() async {
  var status = await Permission.manageExternalStorage.status;
  if (!status.isGranted) {
    await Permission.manageExternalStorage.request();
    status = await Permission.manageExternalStorage.status;
    if (!status.isGranted) {
      // 权限被拒绝，引导用户到设置页面开启
      await openAppSettings();
    }
  }
}

注意：MANAGE_EXTERNAL_STORAGE属于特殊权限，Google Play对其使用有严格限制，仅当应用确实需要访问整个存储系统时才建议使用，否则应优先采用分区存储的媒体访问方式。

内容的提问来源于stack exchange，提问作者autumn