Flutter如何将拍摄的图片保存到指定位置而非临时目录

前置依赖确认 #

首先确保你的pubspec.yaml中已添加对应依赖：

dependencies:
  flutter:
    sdk: flutter
  path_provider: ^2.1.0
  # 如果需要保存到系统公共相册，额外添加以下依赖
  image_gallery_saver: ^2.0.3
  permission_handler: ^11.0.1

场景1：保存到应用专属持久目录 #

该目录属于应用私有存储，不会被系统随意清理，其他应用无法访问，无需额外申请权限，仅需将原有代码中的临时目录接口替换即可：

void _takePicture(BuildContext context) async {
  try {
    await _initializeCameraControllerFuture;
    // 替换getTemporaryDirectory为getApplicationDocumentsDirectory
    final appDir = await getApplicationDocumentsDirectory();
    final path = join(appDir.path, '${DateTime.now().millisecondsSinceEpoch}.png');

    await _cameraController.takePicture(path);
    // 此处path即为持久化存储的图片路径，可直接存入本地数据库后续使用
    Navigator.pop(context, path);
  } catch (e) {
    print(e);
  }
}

场景2：保存到系统公共相册（用户可在系统相册直接查看） #

需要先配置平台权限，再调整代码逻辑：

权限配置 #

• 安卓端：在android/app/src/main/AndroidManifest.xml的manifest标签下添加权限：

  <!-- 安卓13及以上 -->
  <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
  <!-- 安卓12及以下 -->
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
  

• iOS端：在ios/Runner/Info.plist的dict标签下添加权限说明：

  <key>NSPhotoLibraryAddUsageDescription</key>
  <string>需要相册权限保存拍摄的图片</string>
  

代码实现 #

void _takePicture(BuildContext context) async {
  try {
    await _initializeCameraControllerFuture;
    // 先保存到临时目录做中转
    final tempDir = await getTemporaryDirectory();
    final tempPath = join(tempDir.path, '${DateTime.now().millisecondsSinceEpoch}.png');
    await _cameraController.takePicture(tempPath);

    // 申请存储权限
    var status = await Permission.photos.request();
    if (status.isGranted) {
      // 保存到系统相册
      final result = await ImageGallerySaver.saveFile(tempPath);
      if (result['isSuccess']) {
        // 相册保存成功，返回相册路径/或者返回临时路径按需选择
        Navigator.pop(context, result['filePath'] ?? tempPath);
        return;
      }
    }
    // 权限拒绝或保存失败的情况，返回临时路径备用
    Navigator.pop(context, tempPath);
  } catch (e) {
    print(e);
  }
}

核心修改说明 #

• getTemporaryDirectory()获取的是应用临时缓存目录，系统随时可能清理该目录下的文件，仅适合存放临时数据
• getApplicationDocumentsDirectory()获取的是应用专属持久化目录，只有卸载应用或者用户手动清空应用数据时才会被删除，适合存放应用私有的持久化文件
• 若需要让用户能在系统文件管理/相册中看到图片，必须存储到公共目录，同时申请对应平台的存储权限

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