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

Firebase Storage plugin Capacitor

Plugin Capacitor para Firebase Cloud Storage

Instalar

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

Guía

Cómo usar Firebase Storage en Capacitor

Usando @capgo/capacitor-firebase-storage

Plugin Capacitor para Firebase Cloud Storage.

Instalar

bun add @capgo/capacitor-firebase-storage
bunx cap sync

bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.

Importar

import { FirebaseStorage } from '@capgo/capacitor-firebase-storage';

API de un vistazo

Método Descripción
deleteFile Elimina un archivo.
getDownloadUrl Obtén la URL de descarga de un archivo.
getMetadata Obtén los metadatos de un archivo.
listFiles Lista los archivos de un directorio.
updateMetadata Actualiza los metadatos de un archivo.
downloadFile Descarga un archivo.
uploadFile Sube un archivo.
useEmulator Instrumenta tu app para que se comunique con el emulador de Cloud Storage.

Ejemplos

deleteFile()

Elimina un archivo.

import { FirebaseStorage } from '@capgo/capacitor-firebase-storage';

await FirebaseStorage.deleteFile({ path: 'mountains.png' });

getDownloadUrl()

Obtén la URL de descarga de un archivo.

import { FirebaseStorage } from '@capgo/capacitor-firebase-storage';

const result = await FirebaseStorage.getDownloadUrl({ path: 'mountains.png' });
console.log(result);

getMetadata()

Obtén los metadatos de un archivo.

import { FirebaseStorage } from '@capgo/capacitor-firebase-storage';

const result = await FirebaseStorage.getMetadata({ path: 'mountains.png' });
console.log(result);

listFiles()

Lista los archivos de un directorio.

import { FirebaseStorage } from '@capgo/capacitor-firebase-storage';

const result = await FirebaseStorage.listFiles({ path: 'path/to/file' });
// The result holds sensitive values: use it without logging it.

updateMetadata()

Actualiza los metadatos de un archivo.

import { FirebaseStorage } from '@capgo/capacitor-firebase-storage';

await FirebaseStorage.updateMetadata({
  path: 'path/to/file',
  metadata: {},
});

downloadFile()

Descarga un archivo.

import { FirebaseStorage } from '@capgo/capacitor-firebase-storage';

const result = await FirebaseStorage.downloadFile({ path: 'mountains.png' }, (event, error) => {
  console.log(event);
});
console.log(result);

La tabla anterior lista los 8 métodos principales. Los helpers de listener y de versión, y el contrato completo de cada método, están documentados en la repositorio GitHub.

Referencia completa

Continuar con el uso de @capgo/capacitor-firebase-storage

Si estás usando Uso de @capgo/capacitor-firebase-storage para planificar el almacenamiento y la gestión de archivos, conéctalo con @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 funcionalidad nativa en Uso de @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-file para el detalle de implementación en @capgo/capacitor-file, Uso de @capgo/capacitor-file para la funcionalidad nativa en Uso de @capgo/capacitor-file, y @capgo/capacitor-uploader para el detalle de implementación en @capgo/capacitor-uploader.

FAQ

FAQ del plugin Firebase Storage

¿Cómo instalo el plugin Firebase Storage en una app Capacitor?

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

¿Es compatible @capgo/capacitor-firebase-storage con React, Vue y Angular?

Sí. Firebase Storage 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 es compatible con @capgo/capacitor-firebase-storage?

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-firebase-storage gratuito y open source?

Sí. El código fuente de code es público en GitHub en https://github.com/Cap-go/capacitor-firebase/tree/main/packages/storage y el paquete es gratuito para instalar desde npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code que usa Firebase Storage 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 Firebase Storage 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