Guía
Tutorial sobre Compartir Archivos
Usando @capgo/capacitor-compartir-archivos
Compartir y guardar archivos desde datos base64, URLs de datos, rutas de archivos locales, URLs, Android, URIs y __CAPGO_KEEP_0__ file:// URLs. content:// URIs, and Capacitor _capacitor_file_ ¿Qué Exposición Ofrece Este Plugin?
- Abrir la hoja de compartir nativa en Android e iOS, o descargar el archivo en Web.
bun add @capgo/capacitor-file-sharer
bunx cap sync
Compartir archivos y guardarlos desde datos base64, URLs de datos, rutas de archivos locales, URLs, Android, URIs y __CAPGO_KEEP_0__
shareInstalarsave- Guarda en colecciones públicas de Android, abre la hoja de compartir de iOS o descarga en Web.getPluginVersion- Devuelve la versión de implementación del plataforma.
Ejemplo de uso
Compartir un archivo generado
import { FileSharer } from '@capgo/capacitor-file-sharer';
await FileSharer.share({
filename: 'report.pdf',
contentType: 'application/pdf',
base64Data: reportBase64,
title: 'Quarterly report',
text: 'Attached report',
});
Compartir un archivo local
await FileSharer.share({
filename: 'export.zip',
contentType: 'application/zip',
path: fileUri,
});
Guardar en descargas en Android
const result = await FileSharer.save({
filename: 'backup.zip',
contentType: 'application/zip',
base64Data: zipBase64,
android: {
saveDirectory: 'downloads',
relativePath: 'Download/My App',
},
});
console.log(result.uri);
Notas de la plataforma
- El compartir de Android utiliza
FileProvider,ClipData, y las concesiones de URI para que los visores y miniaturas puedan leer el archivo. - El guardar en Android utiliza MediaStore en Android 10+ y directorios públicos en Android 9 y debajo.
- El compartir de iOS admite tanto archivos temporales base64 respaldados como compartir de ruta local directa.
- El compartir y guardar descargas en Web descarga el archivo, con conversión base64 chunked para archivos grandes.
Referencia completa
- GitHub: https://github.com/Cap-go/capacitor-file-sharer/
- Documentación: /docs/plugins/file-sharer/