Guía
Cómo usar Compartir archivos en Capacitor
Usando @capgo/capacitor-file-sharer
Compartir y guardar archivos desde datos base64, URLs de datos y rutas de archivos locales. file:// URLs, Android content:// URIs, y Capacitor _capacitor_file_ URLs.
Install
bun add @capgo/capacitor-file-sharer
bunx cap sync
¿Qué Exposiciones Esta Plugin Realiza
share- Abra la hoja de compartir nativa en Android e iOS, o descargue el archivo en Web.save- Guarda en colecciones públicas de Android, abre la hoja de ahorro/compartir de iOS o descarga en Web.getPluginVersion- Devuelve la versión de implementación de la 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
- La compartición de Android utiliza
FileProvider,ClipDatay URI concede permisos para que el selector muestre previstas y miniaturas del archivo. - La guardado de Android utiliza MediaStore en Android 10+ y directorios públicos en Android 9 y debajo.
- iOS comparte tanto archivos temporales con base64 como rutas locales directas.
- La compartición y el guardado web descargan el archivo, con conversión base64 chunked para archivos grandes.
Referencia completa
- GitHub: https://github.com/Cap-go/capacitor-compartir-archivo/
- Documentación: /docs/plugins/file-sharer/
Continúa desde Using @capgo/capacitor-file-sharer
Si estás utilizando Usando @capgo/capacitor-compartidor-de-archivos para planificar el almacenamiento y el manejo de archivos, conecta con @capgo/capacitor-compartidor-de-archivos para obtener detalles de implementación en @capgo/capacitor-file-sharer Getting Started para obtener detalles de implementación en Getting Started @capgo/capacitor-almacenamiento-de-datos-sqlite para el detalle de implementación en @capgo/capacitor-almacenamiento-sqlite Usando @capgo/capacitor-almacenamiento-sqlite para la capacidad nativa en Usando @capgo/capacitor-almacenamiento-sqlite, y @capgo/capacitor-archivo para el detalle de implementación en @capgo/capacitor-archivo.