Saltar al contenido principal
@capgo/capacitor-compartir-archivos Archivos & Almacenamiento Fuente abierta

Compartir archivos plugin de Capacitor

Compartir y guardar 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 Compartir archivos en Capacitor

Probar en dispositivo

Descarga la aplicación Capgo, luego escanea el código QR code.

File Sharer plugin preview QR code

Usando @capgo/capacitor-file-sharer

Compartir y guardar archivos desde datos base64, URLs de datos y rutas de archivos locales. file:// URLs, Android content:// URIs, y Capacitor _capacitor_file_ URLs.

Install

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

¿Qué Exposiciones Esta Plugin Realiza

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

  • La compartición de Android utiliza FileProvider, ClipDatay URI concede permisos para que el selector muestre previstas y miniaturas del archivo.
  • La guardado de Android utiliza MediaStore en Android 10+ y directorios públicos en Android 9 y debajo.
  • iOS comparte tanto archivos temporales con base64 como rutas locales directas.
  • La compartición y el guardado web descargan el archivo, con conversión base64 chunked para archivos grandes.

Referencia completa

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

Si estás utilizando Usando @capgo/capacitor-compartidor-de-archivos para planificar el almacenamiento y el manejo de archivos, conecta con @capgo/capacitor-compartidor-de-archivos para obtener detalles de implementación en @capgo/capacitor-file-sharer Getting Started para obtener detalles de implementación en Getting Started @capgo/capacitor-almacenamiento-de-datos-sqlite para el detalle de implementación en @capgo/capacitor-almacenamiento-sqlite Usando @capgo/capacitor-almacenamiento-sqlite para la capacidad nativa en Usando @capgo/capacitor-almacenamiento-sqlite, y @capgo/capacitor-archivo para el detalle de implementación en @capgo/capacitor-archivo.

FAQ

Preguntas frecuentes

Cómo instalo el plugin de compartir archivos en una aplicación Capacitor?

Ejecuta "bun add @capgo/capacitor-file-sharer" (o "npm install @capgo/capacitor-file-sharer"), luego ejecuta "bunx cap sync" para que los proyectos iOS y Android capturen el archivo nativo code. Importa desde "@capgo/capacitor-file-sharer" en tu aplicación code.

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

Sí. El compartidor de archivos es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

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

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

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

Sí. El código fuente de code está disponible en GitHub en https://github.com/Cap-go/capacitor-file-sharer/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

Puedo actualizar code que utiliza Compartir Archivos sin una revisión de la Tienda de Aplicaciones?

Instalar o actualizar el complemento cambia el código nativo code, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios de JavaScript, HTML y CSS que llaman al complemento pueden enviar con actualizaciones Capgo en vivo de inmediato.

Envía cambios de File Sharer sin esperar a la revisión de la aplicación

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían cambios en JavaScript, HTML y CSS a los usuarios en minutos.

Comienza con Capgo