Check out what’s new from Firebase at Google I/O 2022. Learn more

Instalar uma extensão do Firebase

Instale (e gerencie) qualquer extensão oficial do Firebase usando o Console do Firebase ou a CLI do Firebase (interface de linha de comando).

Revise as diferenças nas ações compatíveis com a CLI do Firebase e o Console do Firebase.


Para instalar ou gerenciar extensões, é necessário atribuir uma destas funções: Proprietário ou Editor ou Administrador do Firebase.

Para instalar uma extensão, o projeto precisa estar no plano Blaze (pagamento por utilização). Não há cobrança pela instalação de uma extensão, mas você poderá receber cobranças pelo uso de serviços do Firebase ou do Cloud, como o [Cloud Secret Manager][secret-pricing], se o uso exceder o Nível gratuito dos serviços.

Antes de começar

  1. Adicione o Firebase ao seu projeto, caso ainda não tenha feito isso.

  2. Faça upgrade do seu projeto para o plano Blaze (pagamento por utilização), se ainda não tiver feito isso.

  3. Instale ou atualize para a versão mais recente da CLI do Firebase

  4. Anote o ID do projeto do Firebase ou o alias do projeto configurado anteriormente.

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

Esta etapa é opcional, mas altamente recomendada.

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

  • Como a extensão funciona, as tarefas de pré-instalação e os detalhes sobre ela
  • 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. Verifique se você configurou seu ambiente e selecionou uma extensão.

  2. Execute o comando extension-info em qualquer lugar no seu computador:

    firebase ext:info publisher-id/extension-id

    Os argumentos publisher-id e extension-id são obrigatórios e podem ser encontrados na página de detalhes de pré-instalação da extensão.

Etapa 2: instalar uma extensão

Durante o processo de instalação, será solicitado que você analise as especificações básicas da extensão (como APIs ativadas, recursos criados, acesso concedido, etc.). Você será notificado sobre os requisitos de faturamento e solicitado a especificar valores para os parâmetros configuráveis da extensão.

  1. Verifique se você configurou seu ambiente e selecionou uma extensão.

  2. Execute o comando extension-install. Caso solicitado, insira valores de parâmetros para personalizar a instância da extensão.

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    Os argumentos publisher-id e extension-id são obrigatórios e podem ser encontrados na página de detalhes de pré-instalação da extensão.

  3. Após a conclusão da instalação, leia as instruções para usar sua extensão, que pode incluir algumas tarefas pós-instalação obrigatórias.

    • Encontre essas instruções na página de detalhes de pós-instalação da 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).

      Essas instruções também podem ser encontradas no arquivo POSTINSTALL.md incluído no diretório de origem da extensão.

    • Se aplicável, estas instruções mostrarão como testar sua extensão (procure uma seção Veja-a em ação).

Instalar várias instâncias de extensão

É possível 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 recursos de extensão. Identifique e faça referência a cada instância instalada usando o ID da instância exclusivo do projeto. Você precisará confirmar ou editar o ID de cada instância adicional da extensão que instalar.

Próximas etapas

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

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

  • Usando a CLI do Firebase, gerencie a extensão instalada. É possível reconfigurar ou desinstalar sua extensão, bem como atualizar sua extensão para a versão mais recente.

  • Usando o Console do Firebase, gerencie sua extensão instalada. Para extensões oficiais do Firebase, é possível reconfigurar ou desinstalar sua extensão, além de atualizá-la para a versão mais recente.

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