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

Compartidor de archivos

Compartir y guardar archivos desde datos en base64 o rutas locales en Android, iOS y Web

Descargas/semana

201

GitHub Estrellas

1

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

- 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

Este plugin expone la capacidad de compartir archivos nativamente en Android e iOS, y descargar archivos en Web.

  • share - Abrir la hoja de compartir nativa en Android e iOS, o descargar 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

  • Android utiliza compartir, y URI concede para que los visores y miniaturas de la elección puedan leer el archivo. FileProvider, ClipDataAndroid guarda utiliza MediaStore en Android 10+ y directorios públicos en Android 9 y debajo.
  • iOS comparte admite tanto archivos temporales respaldados por base64 como compartir de ruta local directa.
  • Compartir y guardar en Web descarga el archivo, con conversión base64 chunked para archivos grandes.
  • Android sharing uses, and URI grants so chooser previews and thumbnails can read the file.

Referencia Completa