Saltar al contenido principal
@capgo/capacitor-file-sharer Archivos y almacenamiento Código abierto

Compartir archivos plugin Capacitor

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

Instalar

bun add @capgo/capacitor-file-sharer bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-file-sharer
  • pnpm add @capgo/capacitor-file-sharer
  • yarn add @capgo/capacitor-file-sharer

Guía

Cómo usar File Sharer en Capacitor

Probar en el dispositivo

Descarga la app Capgo y escanea el QR code.

QR de vista previa del plugin File Sharer code

Usando @capgo/capacitor-file-sharer

Comparte y guarda archivos desde datos base64, data URLs, rutas de archivos locales, file:// URLs, Android content:// URIs y Capacitor _capacitor_file_ URLs.

Instalar

bun add @capgo/capacitor-file-sharer
bunx cap sync

Lo que expone este plugin

  • share - Abre el menú nativo de compartir en Android e iOS, o descarga el archivo en Web.
  • save - Guarda en colecciones públicas de Android, abre el menú de compartir/guardar de iOS, o descarga en Web.
  • getPluginVersion - Devuelve la versión de la 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

  • Compartir en Android usa FileProvider, ClipData, y permisos de URI para que las vistas previas y miniaturas del selector puedan leer el archivo.
  • Los guardados en Android usan MediaStore en Android 10+ y directorios públicos en Android 9 o inferior.
  • El compartir en iOS admite tanto archivos temporales con base64 como compartir rutas locales directas.
  • El intercambio web y el guardado descargan el archivo, con conversión base64 por bloques para archivos grandes.

Referencia completa

Continúa desde Usando @capgo/capacitor-file-sharer

Si estás usando Usando @capgo/capacitor-file-sharer para planificar el almacenamiento y la gestión de archivos, conéctalo con @capgo/capacitor-file-sharer para el detalle de la implementación en @capgo/capacitor-file-sharer, Primeros pasos para los detalles de implementación en Primeros pasos, @capgo/capacitor-data-storage-sqlite para el detalle de implementación en @capgo/capacitor-data-storage-sqlite, Uso de @capgo/capacitor-data-storage-sqlite para la capacidad nativa en Uso de @capgo/capacitor-data-storage-sqlite, y @capgo/capacitor-file para el detalle de implementación en @capgo/capacitor-file.

FAQ

FAQ del plugin File Sharer

¿Cómo instalo el plugin File Sharer en una app Capacitor?

Ejecuta "bun add @capgo/capacitor-file-sharer" (o "npm install @capgo/capacitor-file-sharer"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android detecten el code nativo. Impórtalo desde "@capgo/capacitor-file-sharer" en el code de tu app.

¿Funciona @capgo/capacitor-file-sharer con React, Vue y Angular?

Sí. File Sharer es un paquete Capacitor, así que funciona con cualquier framework web que corra dentro de Capacitor, incluidos Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-file-sharer?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-file-sharer gratuito y de código abierto?

Sí. El código fuente de code es público en GitHub en https://github.com/Cap-go/capacitor-file-sharer/ y el paquete se puede instalar gratis desde npm. Los reportes de errores y pull requests son bienvenidos.

¿Puedo actualizar code que usa File Sharer sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios de File Sharer sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo