Guía
Tutorial sobre Compartir Archivos
Usando @capgo/capacitor-file-sharer
Compartir y guardar archivos desde datos base64, URLs de datos, rutas de archivos locales, file:// URLs, Android content:// URIs, y Capacitor _capacitor_file_ URLs.
Instalar
bun add @capgo/capacitor-file-sharer
bunx cap sync
¿Qué expone este complemento?
share- Abra la hoja de compartir nativa en Android e iOS, o descargue el archivo en Web.save- Guardar en colecciones públicas de Android, abrir la hoja de guardar/compartir de iOS, o descargar en Web.getPluginVersion- Devuelve la versión de implementación de la plataforma.
Uso de Ejemplo
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);
Observaciones De La Plataforma
- El compartir de Android utiliza
FileProvider,ClipData, y las concesiones de URI para que las vistas previas y las miniaturas del compartidor puedan leer el archivo. - El guardar de Android utiliza MediaStore en Android 10+ y directorios públicos en Android 9 y debajo.
- El compartir de iOS admite tanto archivos temporales respaldados por base64 como compartir de ruta local directa.
- Compartir y guardar archivos descargados, con conversión base64 chunked para archivos grandes.
Referencia completa
- GitHub: https://github.com/Cap-go/capacitor-compartir-archivos/
- Documentación: /docs/plugins/compartir-archivos/
Sigue adelante desde [Usando @capgo/capacitor-compartir-archivos](#usando-@capgo/capacitor-compartir-archivos)
Si estás utilizando [Usando @capgo/capacitor-compartir-archivos](#usando-@capgo/capacitor-compartir-archivos) para planificar el almacenamiento y el manejo de archivos, conecta con [@capgo/capacitor-compartir-archivos](#conectar-con-@capgo/capacitor-compartir-archivos) para obtener detalles de implementación en [ @capgo/capacitor-compartir-archivos](#implementación-en-@capgo/capacitor-compartir-archivos) Inicio rápido para los detalles de implementación en Getting Started, @capgo/capacitor-almacenamiento-de-datos-sqlite para los detalles de implementación en @capgo/capacitor-almacenamiento-de-datos-sqlite, Usando @capgo/capacitor-almacenamiento-de-datos-sqlite para la capacidad nativa en Usando @capgo/capacitor-almacenamiento-de-datos-sqlite, y @capgo/capacitor-archivo para los detalles de implementación en @capgo/capacitor-archivo.