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é Esta Plugin Exposa

• share - Abrir la hoja de compartir nativa en Android e iOS, o descargar el archivo en Web.
• save - Guardar en colecciones públicas de Android, abrir la hoja de compartir/save de iOS, o descargar en Web.
• getPluginVersion - Devolver 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

• Android comparte usando FileProvider, ClipDatay los permisos de URI para que el lector de archivos muestre previstas y miniaturas.
• Android guarda en MediaStore en Android 10+ y en directorios públicos en Android 9 y debajo.
• La compartición de iOS admite tanto archivos temporales base64 respaldados como compartir directamente con un camino local.
• La compartición y el ahorro de descargas descargan 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/