Flutter实现将File保存至手机下载目录的跨平台静态方法需求

要实现将dart:io的File保存到用户手机下载目录，需要依赖两个核心包处理权限和目录路径：

• path_provider：获取各平台的标准下载目录路径
• permission_handler：处理Android和iOS的文件访问权限

完整实现代码 #

import 'dart:io';
import 'package:path_provider/path_provider.dart';
import 'package:permission_handler/permission_handler.dart';

class FileDownloadService {
  static Future<bool> downloadFile(File pickedFile, String fileName) async {
    // 检查并申请必要权限
    bool hasPermission = await _checkAndRequestPermissions();
    if (!hasPermission) {
      return false;
    }

    try {
      // 获取平台对应的下载目录
      Directory? downloadDir;
      if (Platform.isAndroid) {
        downloadDir = await getExternalStorageDirectory();
        // Android 10+ 需指定Download子目录
        if (downloadDir != null) {
          downloadDir = Directory('${downloadDir.path}/Download');
        }
      } else if (Platform.isIOS) {
        downloadDir = await getApplicationDocumentsDirectory();
        // iOS 需通过配置让文件显示在系统文件应用中
      }

      if (downloadDir == null) {
        return false;
      }

      // 确保下载目录存在
      await downloadDir.create(recursive: true);

      // 拼接目标文件路径
      final targetFile = File('${downloadDir.path}/$fileName');

      // 复制源文件到目标路径
      await pickedFile.copy(targetFile.path);

      // iOS 额外处理：让文件能在系统文件应用中可见
      if (Platform.isIOS) {
        // 需在Info.plist中开启UIFileSharingEnabled和LSSupportsOpeningDocumentsInPlace
      }

      return true;
    } catch (e) {
      print('保存文件失败: $e');
      return false;
    }
  }

  /// 检查并申请文件访问权限
  static Future<bool> _checkAndRequestPermissions() async {
    PermissionStatus status;
    if (Platform.isAndroid) {
      status = await Permission.manageExternalStorage.request();
    } else if (Platform.isIOS) {
      status = await Permission.photosAddOnly.request();
      // iOS 需在Info.plist中添加NSPhotoLibraryAddUsageDescription权限描述
    } else {
      return false;
    }
    return status.isGranted;
  }
}

关键说明 #

• 权限配置：
  • Android 11+ 需在AndroidManifest.xml中添加<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"/>
  • iOS 需在Info.plist中添加NSPhotoLibraryAddUsageDescription描述，同时开启UIFileSharingEnabled和LSSupportsOpeningDocumentsInPlace以让文件在系统文件应用中可见
• 目录差异：
  • Android的getExternalStorageDirectory()返回应用私有外部存储根目录，需手动拼接Download子路径才能对应系统下载目录
  • iOS的getApplicationDocumentsDirectory()返回应用私有目录，通过文件共享配置后，用户可在系统文件应用的"我的文件"中找到该文件
• 异常处理：复制文件过程中可能出现权限不足、磁盘空间不足等异常，需捕获并返回失败状态

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