Flutter中如何将cropImage()裁剪后的图片保存到指定文件夹

前置准备 #

首先在pubspec.yaml中添加依赖：

dependencies:
  flutter:
    sdk: flutter
  image_picker: ^latest_version
  image_cropper: ^latest_version
  path_provider: ^2.1.0
  permission_handler: ^10.2.0
  device_info_plus: ^9.1.0 # 用于判断安卓系统版本
  # 如果需要直接保存到系统相册可额外添加 gallery_saver: ^2.3.2

实现步骤 #

1. 权限配置 #

• 安卓端：在android/app/src/main/AndroidManifest.xml中添加存储权限：

  <!-- 安卓13以下读写存储权限 -->
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
  <!-- 安卓13+图片访问权限 -->
  <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
  

• iOS端：在ios/Runner/Info.plist中添加权限说明：

  <key>NSPhotoLibraryAddUsageDescription</key>
  <string>需要访问相册保存图片</string>
  <key>NSPhotoLibraryUsageDescription</key>
  <string>需要访问相册选取图片</string>
  

2. 申请存储权限 #

操作文件前先调用权限申请方法：

Future<bool> requestStoragePermission() async {
  if (Platform.isAndroid) {
    final androidInfo = await DeviceInfoPlugin().androidInfo;
    if (androidInfo.version.sdkInt >= 33) {
      var status = await Permission.photos.request();
      return status.isGranted;
    } else {
      var status = await Permission.storage.request();
      return status.isGranted;
    }
  } else if (Platform.isIOS) {
    var status = await Permission.photosAddOnly.request();
    return status.isGranted;
  }
  return false;
}

3. 复制裁剪后的图片到自定义目录 #

你可以根据使用场景选择两种存储位置：

• 方案A：存储到应用私有目录：不需要额外权限，应用卸载后图片会被删除，适合仅应用内使用的图片

  Future<File> saveToAppDir(File croppedImage, String fileName) async {
    // 获取应用私有文档目录
    final appDir = await getApplicationDocumentsDirectory();
    // 自定义子目录
    final customDir = Directory('${appDir.path}/my_custom_images');
    if (!await customDir.exists()) {
      await customDir.create(recursive: true);
    }
    // 拼接目标完整路径
    final targetPath = '${customDir.path}/$fileName.jpg';
    // 复制裁剪后的缓存文件到目标路径
    return await croppedImage.copy(targetPath);
  }
  

• 方案B：存储到公共存储目录：需要存储权限，应用卸载后图片仍保留，用户可在系统文件管理器/相册查看

  Future<File> saveToPublicDir(File croppedImage, String fileName) async {
    // 安卓获取公共DCIM目录，iOS可按需替换为相册目录
    final? publicDir = await getExternalStorageDirectory();
    final customDir = Directory('${publicDir?.path}/DCIM/my_custom_images');
    if (!await customDir.exists()) {
      await customDir.create(recursive: true);
    }
    final targetPath = '${customDir.path}/$fileName.jpg';
    return await croppedImage.copy(targetPath);
  }
  

  如果需要直接存入系统相册，也可以直接调用gallery_saver包的GallerySaver.saveImage(croppedImage.path)方法，无需手动拼接路径

修改后的完整pickImage代码 #

Future pickImage(source) async {
  try {
    // 先校验存储权限
    bool hasPermission = await requestStoragePermission();
    if (!hasPermission) {
      print("无存储权限，无法保存图片");
      return;
    }

    final pickedFile = await ImagePicker().pickImage(source: source);
    if (pickedFile == null) return;

    File? croppedImage = await ImageCropper.cropImage(
        sourcePath: pickedFile.path,
        aspectRatio: CropAspectRatio(ratioX: 1.0, ratioY: 1.0)
    );
    if(croppedImage == null) return;

    // 用时间戳作为文件名避免重复
    String fileName = DateTime.now().millisecondsSinceEpoch.toString();
    // 按需选择存储方案，示例使用应用私有目录
    File savedImage = await saveToAppDir(croppedImage, fileName);

    this.image = savedImage;
    setState((){});
   } on PlatformException catch (e) {
    print('Failed to process image: $e');
  }
}

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