Catch up on everthing we announced at this year's Firebase Summit. 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.

Além disso, para instalar uma extensão, o projeto precisa estar no plano Blaze (pagamento por utilização). Será cobrada uma pequena quantia (normalmente cerca de US$ 0,01/mês) pelos recursos do Firebase exigidos por essa extensão (mesmo que ela não seja usada), além de qualquer cobrança associada ao seu uso.

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.