如何将Android缓存目录中的文件复制到下载目录？

前提说明 #

你已通过FTP将文件下载到App的缓存目录（路径示例：/data/user/0/package name/cache/fileName），以下是将该文件复制到Android公共下载目录的具体实现步骤。

所需依赖 #

除已使用的path_provider外，还需添加permission_handler用于申请存储权限（适配Android 6.0+权限机制及Scoped Storage）：
在pubspec.yaml中添加：

dependencies:
  path_provider: ^2.1.1
  permission_handler: ^11.0.1

完整实现代码 #

1. 权限申请方法 #

先实现存储权限的申请逻辑，确保App有权限写入公共下载目录：

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

Future<bool> _requestStoragePermission() async {
  PermissionStatus status;
  if (await Permission.storage.isGranted) {
    return true;
  } else {
    status = await Permission.storage.request();
    return status.isGranted;
  }
}

2. 文件复制到下载目录的方法 #

实现从缓存目录复制文件到公共下载目录的逻辑：

Future<void> _copyFileToDownloads(String fileName) async {
  try {
    // 1. 申请存储权限
    bool hasPermission = await _requestStoragePermission();
    if (!hasPermission) {
      print("存储权限未获取，无法复制文件");
      return;
    }

    // 2. 获取缓存目录中的源文件
    Directory cacheDir = await getTemporaryDirectory();
    File sourceFile = File("${cacheDir.path}/$fileName");
    if (!await sourceFile.exists()) {
      print("缓存目录中不存在目标文件");
      return;
    }

    // 3. 获取Android公共下载目录
    Directory? downloadsDir = await getDownloadsDirectory();
    if (downloadsDir == null) {
      print("无法获取下载目录");
      return;
    }

    // 4. 构建目标文件路径，避免重名可添加时间戳或判断文件存在
    String targetPath = "${downloadsDir.path}/$fileName";
    int counter = 1;
    while (await File(targetPath).exists()) {
      // 文件已存在时重命名，比如fileName(1).ext
      String extension = fileName.split('.').last;
      String baseName = fileName.substring(0, fileName.lastIndexOf('.'));
      targetPath = "${downloadsDir.path}/$baseName($counter).$extension";
      counter++;
    }

    // 5. 执行复制操作
    await sourceFile.copy(targetPath);
    print("文件已成功复制到下载目录：$targetPath");
  } catch (e) {
    print("复制文件出错：${e.toString()}");
  }
}

3. 整合到原有逻辑 #

可以在文件下载完成后调用上述复制方法，修改你的_fileMock方法：

Future<void> _fileMock(String strFileName) async {
  try {
    final Directory appDocDir = await getTemporaryDirectory()..createSync(recursive: true);
    String appDocPath = appDocDir.path;
    print('appDocPath : $appDocPath');
    _file = File('$appDocPath/$strFileName');
    setSavePath('$appDocPath/$strFileName');
    print('file : $_file'); // 修正变量名错误，原代码中是_file而非file

    // 文件下载完成后，调用复制到下载目录的方法
    await _copyFileToDownloads(strFileName);
  } catch(e){
    print('_fileMock Error : ${e.toString()}');
    final File file = File('');
  }
}

注意事项 #

• Android版本适配：Android 10（API 29）及以上采用Scoped Storage，getDownloadsDirectory()会返回公共下载目录，无需额外处理；Android 9及以下需确保WRITE_EXTERNAL_STORAGE权限已获取。
• 文件重名处理：代码中已添加重名文件的自动重命名逻辑，避免覆盖已有文件。
• 权限申请提示：首次申请权限时，需向用户说明权限用途，提升用户授权意愿。

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