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 a Firebase CLI (interface de linha de comando).

Certifique-se de revisar as diferenças nas ações compatíveis com Firebase CLI e 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 dos serviços Firebase ou Cloud, como o Cloud Secret Manager , se o 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 Firebase para o plano Blaze (pagamento 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ê revise as 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 cobrança
  • Serviços do Google (APIs) e funções de acesso necessárias para a operação
  • Recursos criados para a extensão (como funções)
  • Descrições de parâmetros configuráveis ​​pelo usuário

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

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

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

Passo 2 : Instale uma extensão

Durante o processo de instalação, você será solicitado a revisar as especificações básicas da extensão (como APIs ativadas, 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 Marketplace de extensões .

  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 : Conclua a configuração pós-instalação

Algumas extensões têm etapas obrigatórias ou opcionais a serem concluídas antes de usá-las. Encontre essas instruções na página de detalhes de pós-instalação da 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 publicar eventos e você ativar eventos durante a instalação, poderá 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 execução longa 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 acionadores 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 refere-se 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 instalada.

Próximos passos

  • Visualize os detalhes e a configuração de sua extensão instalada no console do Firebase.

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

  • Usando o Firebase console, 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 cobrança no Firebase console.

,

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

Certifique-se de revisar as diferenças nas ações compatíveis com Firebase CLI e 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 dos serviços Firebase ou Cloud, como o Cloud Secret Manager , se o 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 Firebase para o plano Blaze (pagamento 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ê revise as 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 cobrança
  • Serviços do Google (APIs) e funções de acesso necessárias para a operação
  • Recursos criados para a extensão (como funções)
  • Descrições de parâmetros configuráveis ​​pelo usuário

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

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

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

Passo 2 : Instale uma extensão

Durante o processo de instalação, você será solicitado a revisar as especificações básicas da extensão (como APIs ativadas, 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 Marketplace de extensões .

  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 : Conclua a configuração pós-instalação

Algumas extensões têm etapas obrigatórias ou opcionais a serem concluídas antes de usá-las. Encontre essas instruções na página de detalhes de pós-instalação da 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 publicar eventos e você ativar eventos durante a instalação, poderá 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 execução longa 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 acionadores 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 refere-se 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 instalada.

Próximos passos

  • Visualize os detalhes e a configuração de sua extensão instalada no console do Firebase.

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

  • Usando o Firebase console, 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 cobrança no Firebase console.