获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Instalar uma extensão do Firebase

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

  1. Se ainda não o fez, adicione o Firebase ao seu projeto .

  2. Se ainda não o fez, atualize seu projeto para o plano Blaze (pagamento conforme o uso).

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

  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 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. Verifique se você configurou seu ambiente e selecionou uma extensão .

  2. Execute o comando extension-info de qualquer lugar em 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, 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. Verifique se você configurou seu ambiente e selecionou uma extensão .

  2. No diretório local do Firebase, execute o comando extension-install. Se solicitado, insira valores de parâmetro para personalizar a instância de 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 .

    A execução deste comando adiciona uma instância de extensão ao seu manifesto de extensões .

  3. Em seguida, para implantar as extensões em seu manifesto em um projeto do Firebase, execute:

    firebase deploy --only extensions --project=projectId-or-alias

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 a Firebase CLI, gerencie sua extensão instalada. Você pode 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, 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.