Saltar al contenido principal
Volver a plugins
@capgo/capacitor-compartidor-de-archivos
Tutoriales
@capgo/capacitor-compartidor-de-archivos

Icono del plugin Compartidor de archivos

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

Guía

Tutorial sobre Compartir Archivos

Probar en dispositivo

Descargar la Capgo app, luego escanea el código QR code.

Enlace QR de vista previa del complemento File Sharer code

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é expone este complemento?

  • share - Abra la hoja de compartir nativa en Android e iOS, o descargue el archivo en Web.
  • save - Guardar en colecciones públicas de Android, abrir la hoja de guardar/compartir de iOS, o descargar en Web.
  • getPluginVersion - Devuelve la versión de implementación de la plataforma.

Uso de Ejemplo

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);

Observaciones De La Plataforma

  • El compartir de Android utiliza FileProvider, ClipData, y las concesiones de URI para que las vistas previas y las miniaturas del compartidor puedan leer el archivo.
  • El guardar de Android utiliza MediaStore en Android 10+ y directorios públicos en Android 9 y debajo.
  • El compartir de iOS admite tanto archivos temporales respaldados por base64 como compartir de ruta local directa.
  • Compartir y guardar archivos descargados, con conversión base64 chunked para archivos grandes.

Referencia completa

Sigue adelante desde [Usando @capgo/capacitor-compartir-archivos](#usando-@capgo/capacitor-compartir-archivos)

Si estás utilizando [Usando @capgo/capacitor-compartir-archivos](#usando-@capgo/capacitor-compartir-archivos) para planificar el almacenamiento y el manejo de archivos, conecta con [@capgo/capacitor-compartir-archivos](#conectar-con-@capgo/capacitor-compartir-archivos) para obtener detalles de implementación en [ @capgo/capacitor-compartir-archivos](#implementación-en-@capgo/capacitor-compartir-archivos) Inicio rápido para los detalles de implementación en Getting Started, @capgo/capacitor-almacenamiento-de-datos-sqlite para los detalles de implementación en @capgo/capacitor-almacenamiento-de-datos-sqlite, Usando @capgo/capacitor-almacenamiento-de-datos-sqlite para la capacidad nativa en Usando @capgo/capacitor-almacenamiento-de-datos-sqlite, y @capgo/capacitor-archivo para los detalles de implementación en @capgo/capacitor-archivo.