O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Redimensionar imagens

Firebase
Made by Firebase

Redimensiona as imagens enviadas ao Cloud Storage visando um tamanho especificado e, opcionalmente, mantém ou exclui a imagem original.

Como esta extensão funciona

Use esta extensão para criar versões redimensionadas de uma imagem enviada a um bucket do Cloud Storage.

Quando você faz upload de um arquivo para o bucket especificado do Cloud Storage, esta extensão:

  • detecta se o arquivo é uma imagem. Se for, então:
  • cria uma imagem redimensionada com as dimensões especificadas.
  • Nomeia a imagem redimensionada usando o mesmo nome da imagem original enviada, mas seguida com a largura e altura especificadas.
  • Armazena o redimensionamento no mesmo bucket do Storage que a imagem original enviada.

Você pode até configurar a extensão para criar imagens redimensionadas de diferentes dimensões para cada upload de imagem original. Por exemplo, se você quiser imagens 200 x 200, 400 x 400 e 680 x 680, a extensão as criará e armazenará no bucket.

Ela automaticamente copia os seguintes metadados, se eles estiverem presentes, da imagem original para as redimensionadas: Cache-Control , Content-Disposition , Content-Encoding , Content-Language , Content-Type e metadados fornecidos pelo usuário. Caso os metadados originais incluam um token, um novo token de download do Firebase Storage será gerado nas imagens redimensionadas. Se preferir, configure a extensão para substituir o valor do Controle de cache nas imagens redimensionadas.

A extensão pode publicar um evento de conclusão de redimensionamento que pode ser ativado opcionalmente na instalação da extensão. Ao ativar eventos, poderá gravar manipuladores de eventos personalizados que respondem a esses eventos. É possível ativar ou desativar eventos depois. Os eventos serão emitidos pelo Eventarc.

Informações detalhadas de configuração

Para configurar essa extensão, especifique a largura e a altura máximas em pixels ou px. A extensão mantém constante a proporção das imagens enviadas e as reduz até que as dimensões delas sejam iguais ou menores que a altura e a largura máximas especificadas.

Por exemplo, imagine que você quer especificar a largura máxima de 200 px e a altura máxima de 100 px. Você envia uma imagem que tenha 480 px de largura por 640 px de altura, o que significa uma proporção de 0,75. A imagem final redimensionada será de 75 pixels de largura por 100 pixels de altura para manter a proporção sem exceder as duas dimensões máximas especificadas.

Outras configurações

Antes de instalar esta extensão, confira se você configurou um bucket do Cloud Storage no seu projeto do Firebase.

OBSERVAÇÃO : conforme mencionado acima, esta extensão detecta todas as alterações feitas no bucket especificado do Cloud Storage. Isso pode causar chamadas de função desnecessárias. É recomendável criar um bucket separado do Cloud Storage, especialmente para imagens que você quer redimensionar, e configurar essa extensão para detectar esse bucket.

Várias instâncias desta extensão

É possível instalar várias instâncias dessa extensão para o mesmo projeto para configurar opções de redimensionamento diferentes para caminhos diferentes. No entanto, conforme mencionado anteriormente, essa extensão detecta todas as alterações feitas no bucket especificado do Cloud Storage. Isso significa que todas as instâncias vão ser acionadas sempre que um arquivo for enviado para o bucket. Portanto, é recomendável usar buckets diferentes em vez de caminhos diferentes para evitar chamadas de função desnecessárias.

Faturamento

Para instalar uma extensão, o projeto precisa estar no Blaze (pagamento por utilização) plano

  • Haverá uma pequena cobrança (normalmente cerca de US$ 0,01/mês) pelos recursos do Firebase exigidos por essa extensão (mesmo que ela não seja usada).
  • Esta extensão usa outros serviços do Firebase e do Google Cloud Platform, que têm cobranças associadas se você exceder o nível sem custo financeiro do serviço:
  • Cloud Storage
  • Cloud Functions (Tempo de execução do Node.js 10+. Consulte as perguntas frequentes )
  • Se você ativar eventos sujeito a taxas do Eventarc.

Como instalar a extensão

Como usar o Console do Firebase

Para instalar e gerenciar extensões, use o Console do Firebase.

Instalar usando o console

Como usar a Firebase CLI

Para instalar e gerenciar extensões, também é possível usar a Firebase CLI:

Etapa 1: execute o comando npm (em inglês) a seguir para instalar a CLI ou atualizá-la para a versão mais recente.

npm install -g firebase-tools
Não está funcionando? Consulte a referência da Firebase CLI ou altere suas permissões do npm (em inglês).

Etapa 2: configurar um novo diretório do projeto no Firebase ou acessar um já configurado

Etapa 3: adicionar esta extensão ao seu manifesto de extensões ao ser executada

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

Etapa 5: implantar as extensões do seu manifesto ao projeto

firebase deploy --only extensions --project=projectId_or_alias
Compatível com
Cloud Storage
Autor
Licença
Apache-2.0
Versão
0.1.29