如何使用Flutter删除任意存储文件？

核心逻辑 #

删除文件的核心是通过文件路径定位目标文件，借助Flutter原生API或第三方工具包完成操作，同时要适配不同平台的权限规则。

分步实现 #

1. 权限处理（必备步骤） #

不同平台对存储访问的权限要求不同，必须先申请对应权限：

• Android：在AndroidManifest.xml中添加权限声明

  <!-- Android 12及以下版本 -->
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  <!-- Android 13+ 需单独申请媒体权限 -->
  <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
  <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
  <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
  

• iOS：在Info.plist中添加隐私权限描述

  <key>NSPhotoLibraryUsageDescription</key>
  <string>需要访问相册以删除文件</string>
  

可以用permission_handler包动态申请权限：

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

Future<bool> requestStoragePermission() async {
  PermissionStatus status;
  if (Platform.isAndroid) {
    // 区分Android版本处理权限
    final androidVersion = await AndroidInfo.version;
    status = androidVersion >= 13 
        ? await Permission.photos.request() 
        : await Permission.storage.request();
  } else {
    status = await Permission.photos.request();
  }
  return status.isGranted;
}

2. 删除文件操作 #

使用dart:io的File类完成基础删除：

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

// 删除指定路径的文件
Future<bool> deleteFile(String filePath) async {
  final file = File(filePath);
  try {
    if (await file.exists()) {
      await file.delete();
      return true;
    }
    return false;
  } catch (e) {
    print('删除失败: $e');
    return false;
  }
}

// 示例：删除应用缓存目录下的临时文件
Future<void> deleteCacheTempFile() async {
  final cacheDir = await getTemporaryDirectory();
  final targetPath = '${cacheDir.path}/temp_cache.txt';
  await deleteFile(targetPath);
}

3. 处理Android外部公共目录文件 #

Android 10+采用分区存储，直接通过File删除公共目录（如Downloads、Pictures）的文件会受限，需用MediaStore API，可借助media_store包简化：

import 'package:media_store/media_store.dart';

Future<bool> deletePublicStorageFile(String filePath) async {
  try {
    await MediaStore.deleteFile(filePath);
    return true;
  } catch (e) {
    print('删除公共文件失败: $e');
    return false;
  }
}

注意事项 #

• 必须确保权限已授予，否则会抛出权限异常
• 删除前务必检查文件是否存在，避免无效操作
• Android 10+无法直接访问外部公共目录的文件路径，需通过MediaStore或SAF（存储访问框架）处理
• iOS仅允许删除应用沙盒内或用户授权访问的文件

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