simple_image_and_video_saver #

Un plugin de Flutter para guardar imágenes y videos en carpetas específicas de Android como Downloads, Pictures o almacenamiento privado, compatible con Android 8 a 15.

💡 Características #

• Guarda imágenes o videos en la galería (Pictures / Movies)
• Guarda imágenes o videos en la carpeta de descargas (Downloads)
• Guarda archivos en el almacenamiento privado de la app
• Compatible con Android 8.0 (API 26) a Android 15
• Basado en Method Channels nativos (Kotlin).
• Soporte completo para errores (PlatformException) si ocurre un fallo.

📦 Instalación #

Agrega este paquete a tu archivo pubspec.yaml:

dependencies:
  simple_image_and_video_saver: ^0.1.0

Luego ejecuta:

flutter pub get

🧪 Uso rápido #

Importa el paquete y llama a los métodos disponibles:

import 'package:simple_image_and_video_saver/simple_image_and_video_saver.dart';

final savedPath = await SimpleImageAndVideoSaver.saveMediaToGallery(
  filePath: '/storage/emulated/0/Download/sample.jpg',
  fileName: 'sample',
  mediaType: MediaType.image,
);

También puedes guardar en descargas o de forma privada:

🧩 Métodos disponibles #

📁 Guardar en Galería #

Future<String?> saveMediaToGallery({
  required String filePath,
  required String fileName,
  required MediaType mediaType, // image o video
});

📁 Guardar imagen en Descargas #

Future<String?> saveImageToDownloads({
  required String filePath,
  required String fileName,
});

📁 Guardar video en Descargas #

Future<String?> saveVideoToDownloads({
  required String filePath,
  required String fileName,
});

🔒 Guardar en almacenamiento privado #

Future<String?> savePrivateMedia({
  required String filePath,
  required String fileName,
});

⚙️ Permisos requeridos #

Debes agregar estos permisos en el archivo AndroidManifest.xml:

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="28" />

Además, a partir de Android 10+, asegúrate de solicitar permisos en tiempo de ejecución y agregar esto dentro de la etiqueta <application>:

android:requestLegacyExternalStorage="true"

🧪 Ejemplo #

Puedes encontrar un ejemplo completo en el directorio example/.

📁 Plataformas compatibles #

Plataforma	Compatibilidad
Android	    ✅ Soportado (API 26 - 34)
iOS	        ❌ No soportado (por ahora)

📍 Próximamente #

• Soporte para iOS
• Soporte para otros tipos de archivos
• Más opciones de personalización

🧑‍💻 Contribuciones #

¡Las contribuciones están abiertas! Por favor revisa el archivo CONTRIBUTING.md (próximamente) o abre un issue con tu propuesta.

📋 Licencia #

MIT License
Copyright © 2025