Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Instalar uma extensão do Firebase

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Você pode instalar (e gerenciar ) qualquer uma das extensões oficiais do Firebase usando o Firebase console ou o Firebase CLI (interface de linha de comando).

Certifique-se de revisar as diferenças nas ações compatíveis com o Firebase CLI e o Firebase console.


Para instalar ou gerenciar extensões, você deve receber uma destas funções: Proprietário ou Editor ou Administrador do Firebase .

Para instalar uma extensão, seu projeto deve estar no plano Blaze (pay as you go). Embora não haja cobrança pela instalação de uma extensão, você pode ser cobrado pelo uso de serviços do Firebase ou serviços de nuvem, como o Cloud Secret Manager , se seu uso exceder o nível gratuito dos serviços.

Antes de você começar

Se ainda não o fez, adicione o Firebase ao seu projeto e atualize seu projeto do Firebase para o plano Blaze (pague conforme o uso).

Etapa 1 : visualizar informações detalhadas sobre uma extensão

Esta etapa é opcional, mas fortemente recomendada.

Antes de instalar uma extensão do Firebase, recomendamos que você analise informações detalhadas sobre a extensão, incluindo:

  • Como a extensão funciona, quaisquer tarefas de pré-instalação e detalhes sobre a extensão
  • Informações gerais de identificação e descrição
  • Se as tarefas da extensão exigem uma conta de faturamento
  • Serviços do Google (APIs) e papéis de acesso necessários para operação
  • Recursos criados para a extensão (como funções)
  • Descrições de parâmetros configuráveis ​​pelo usuário

Para visualizar as informações detalhadas de uma extensão:

  1. Navegue pelas extensões oficiais do Firebase no Extensions Marketplace .

  2. Clique no cartão de uma extensão para:

Etapa 2 : instalar uma extensão

Durante o processo de instalação, você será solicitado a revisar as especificações básicas da extensão (como APIs habilitadas, recursos criados, acesso concedido etc.). Você será notificado sobre quaisquer requisitos de cobrança e também será solicitado a especificar valores para os parâmetros configuráveis ​​da extensão.

  1. Navegue pelas extensões oficiais do Firebase no Extensions Marketplace .

  2. Clique no cartão de uma extensão e revise as informações detalhadas da extensão, que podem oferecer instruções de uso específicas e quaisquer tarefas de pré-instalação.

  3. Clique em Instalar e siga as instruções na tela para instalar a extensão.

Etapa 3 : Concluir a configuração pós-instalação

Algumas extensões têm etapas obrigatórias ou opcionais para você concluir antes de usá-las. Encontre estas instruções na página de detalhes de pós-instalação de sua extensão no painel Extensões do console do Firebase (o link específico para o painel é exibido no terminal após a instalação).

Você também pode encontrar essas instruções no arquivo POSTINSTALL.md incluído no diretório de origem da extensão .

Criar recursos do Firebase

Se você configurou a extensão para usar recursos do Firebase (coleções do Cloud Firestore, caminhos do Realtime Database, buckets do Cloud Storage) que ainda não existem, crie-os antes de usar a extensão.

Criar manipuladores de eventos Eventarc

Algumas extensões publicam no Eventarc quando eventos importantes acontecem durante a execução. Se uma extensão publica eventos e você habilitou eventos durante a instalação, você pode escrever funções que reajam a esses eventos com sua própria lógica personalizada. Isso pode ser útil, por exemplo, para notificar os usuários quando tarefas de longa duração forem concluídas ou para pós-processar a saída de uma função de extensão.

Consulte a documentação da extensão para obter uma lista de eventos (se houver) que ela publica.

Em seguida, consulte Gatilhos de eventos personalizados para obter informações sobre como escrever manipuladores de eventos Eventarc.

Instalar várias instâncias de extensão

Você pode instalar a mesma extensão mais de uma vez no mesmo projeto. Cada instância instalada pode ter sua própria configuração personalizada e seus próprios recursos de extensão. Você identifica e faz referência a cada instância instalada usando seu ID de instância , que é exclusivo em seu projeto. Você será solicitado a confirmar ou editar o ID da instância de cada instância adicional da extensão que instalar.

Próximos passos

  • Veja os detalhes e a configuração da sua extensão instalada no Firebase console.

  • Monitore a atividade de sua extensão instalada, incluindo verificações de integridade, uso e logs.

  • Usando o console do Firebase, gerencie sua extensão instalada. Para extensões oficiais do Firebase, você pode reconfigurar ou desinstalar sua extensão, bem como atualizar sua extensão para a versão mais recente.

  • Como prática recomendada para todos os projetos, configure alertas de orçamento para seu projeto e monitore seu painel de uso e faturamento no Firebase console.