Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Cambia el tamaño de las imágenes

Firebase
Made by Firebase

Cambia el tamaño de las imágenes subidas a Cloud Storage al tamaño que se especifique. Opcionalmente, también puede conservar o borrar la imagen original.

Cómo funciona esta extensión

Usa esta extensión para crear versiones redimensionadas de una imagen subida a un bucket de Cloud Storage.

Cuando subes un archivo al bucket de Cloud Storage especificado, la extensión lleva a cabo estas tareas:

  • Detecta si el archivo es una imagen. Si es así, entonces:
  • Crea una imagen redimensionada con las dimensiones especificadas.
  • Le asigna a la imagen redimensionada el mismo nombre que la imagen subida originalmente, pero con el sufijo de la altura y el ancho especificados.
  • Almacena la imagen redimensionada en el mismo bucket de Storage que la imagen subida originalmente.

Incluso puedes configurar la extensión a fin de crear imágenes redimensionadas de diferentes dimensiones para cada carga de imagen original. Por ejemplo, supón que quieres imágenes de 200 x 200, 400 x 400 y 680 x 680. La extensión puede crear esas tres imágenes redimensionadas y almacenarlas en tu bucket.

La extensión copiará automáticamente los siguientes metadatos de la imagen original si están disponibles: Cache-Control , Content-Disposition , Content-Encoding , Content-Language , Content-Type y los metadatos suministrados por el usuario (un token de descarga nuevo de Firebase Storage se generará en las imágenes con el diseño modificado, si los metadatos originales contienen un token). Ten en cuenta que, de manera opcional, puedes configurar la extensión para reemplazar el valor "Cache-Control" de las imágenes redimensionadas.

La extensión puede publicar un evento de finalización del cambio de tamaño, que puedes habilitar opcionalmente cuando la instales. Si habilitas los eventos, puedes escribir controladores de eventos personalizados que respondan a ellos. Puedes habilitar o inhabilitar eventos cuando quieras. Los eventos se emitirán mediante Eventarc.

Información detallada sobre la configuración

Para configurar esta extensión, especifica el ancho máximo y la altura máxima (en píxeles, px). La extensión conserva la relación de aspecto de las imágenes subidas y las reduce hasta alcanzar un valor igual o inferior al máximo de ancho y alto que especificaste.

Por ejemplo, supongamos que especificaste un ancho máximo de 200 px y un alto máximo de 100 px. Subes una imagen que tiene 480 px de ancho por 640 px de alto (es decir, su relación de aspecto es de 0.75). El tamaño final de la imagen será de 75 píxeles de ancho por 100 píxeles de alto para mantener la relación de aspecto y, al mismo tiempo, cumplir con las dos dimensiones máximas especificadas.

Configuración adicional

Antes de instalar esta extensión, asegúrate de haber configurado un bucket de Cloud Storage en tu proyecto de Firebase.

NOTA : Como se mencionó anteriormente, esta extensión detecta todos los cambios realizados en el bucket de Cloud Storage especificado. Esto puede generar llamadas innecesarias a funciones. Te recomendamos que crees otro bucket de Cloud Storage, especialmente para las imágenes a las que quieras cambiarles el tamaño, y configures esta extensión a fin de que escuche a ese bucket.

Varias instancias de esta extensión

Puedes instalar varias instancias de esta extensión para el mismo proyecto a fin de configurar diferentes opciones de cambio de tamaño para diferentes rutas. Sin embargo, como se mencionó antes, esta extensión detecta todos los cambios realizados en el bucket de Cloud Storage especificado. Eso significa que todas las instancias se activarán cada vez que se suba un archivo al bucket. Por lo tanto, se recomienda usar diferentes buckets en lugar de rutas diferentes a fin de evitar llamadas innecesarias a funciones.

Facturación

Para instalar una extensión, tu proyecto debe tener el plan Blaze (pago por uso)

  • Se te cobrará un pequeño importe (aproximadamente USD 0.01 al mes) por los recursos de Firebase que usa esta extensión (incluso si no la usas). .
  • Esta extensión usa otros servicios de Firebase y Google Cloud Platform que tienen cargos asociados si excedes el nivel gratuito:
  • Cloud Storage
  • Cloud Functions (entorno de ejecución Node.js 10+; consulta la sección de Preguntas frecuentes )
  • Si habilitas los eventos, se aplican las tarifas de Eventarc.

Cómo instalar esta extensión

Usa Firebase console

Puedes usar Firebase console para instalar y administrar las extensiones.

Instala con console

Usa Firebase CLI

También puedes usar Firebase CLI para instalar y administrar las extensiones.

Paso 1: Ejecuta el siguiente comando npm para instalar la CLI o actualizarla a la versión más reciente.

npm install -g firebase-tools
¿No funciona? Consulta la referencia de Firebase CLI o cambia tus permisos de npm.

Paso 2: Configura un nuevo directorio de proyecto de Firebase o navega a uno existente

Paso 3: Agrega esta extensión al manifiesto de tu extensión ejecutando

firebase ext:install firebase/storage-resize-images --local --project=projectId_or_alias

Step 4 (Optional): Test this extension locally with the Firebase Emulator Suite

firebase emulators:start

Paso 5: Implementa las extensiones en el manifiesto de tu proyecto

firebase deploy --only extensions --project=projectId_or_alias
Admite
Cloud Storage
Autor
Licencia
Apache-2.0
Versión
0.1.29