Pular al contenido principal
Volver a plugins
@capgo/capacitor-compartidor-de-archivos
Tutoriales
por github.com/Cap-go

Compartidor de archivos

Comparte y guarda archivos desde datos en base64 o rutas locales en Android, iOS y Web

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__

  • share Instalar
  • save - 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