Visão geral

O Firebase Extensions ajuda a reduzir o tempo gasto no desenvolvimento, na manutenção e no crescimento do seu app.

Quando você encontrar uma Firebase Extension que resolva a necessidade do seu aplicativo ou projeto, basta instalar e configurar a extensão. Se você precisar de várias configurações da extensão, instale a extensão várias vezes, com uma configuração diferente para cada instância instalada.

Com as extensões, você não passa tempo pesquisando, escrevendo e depurando o código que implementa o recurso ou automatiza uma tarefa para seu app ou projeto.

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). A instalação de uma extensão é feita sem custos financeiros, mas você poderá receber cobranças pelo uso de serviços do Firebase ou do Cloud, como o Cloud Secret Manager, se o uso exceder o Nível sem custos financeiros dos serviços.

Também é possível avaliar as extensões antes de instalá-las em um projeto usando o Emulador Extensions, um componente da Firebase Local Emulator Suite.

Extensões oficiais do Firebase

As extensões oficiais do Firebase são desenvolvidas e testadas pelo Firebase e pelos serviços de parceiros do Firebase Extensions. Essas extensões são confiáveis e seguras.

Procurar extensões do Firebase

Procure extensões do Firebase no Extensions Hub.

Ver o código-fonte de uma extensão

Para encontrar um link para o código-fonte de uma extensão, clique em Saiba mais no card da extensão no Extensions Hub.

Conteúdo do código-fonte de uma extensão

O diretório de origem de uma extensão inclui:

  • Arquivo extension.yaml: contém os metadados da extensão e define os recursos criados, as APIs do Google e os papéis de acesso necessários para operação e todos os parâmetros configurados pelo usuário (variáveis de ambiente) para a extensão

  • diretório de funções: contém os arquivos do código-fonte da extensão

  • Arquivo README: lista os metadados da extensão (mas em um formato mais legível), bem como o conteúdo do arquivo PREINSTALL

  • Arquivo PREINSTALL: descreve como a extensão funciona, as tarefas de pré-instalação, os requisitos de configuração e os detalhes necessários sobre ela.

  • Arquivo POSTINSTALL: descreve instruções de uso específicas e outros requisitos de integração

Recursos para uma extensão

Cada projeto do Firebase contém vários tipos de "recursos". Eles podem incluir itens como funções do Cloud implantadas, instâncias de banco de dados, buckets do Cloud Storage, jobs do Cloud Scheduler e dados do Cloud Secret Manager.

Quando você instala uma extensão, o Firebase cria novos recursos específicos da instância de extensão no projeto. Ela precisa desses recursos para funcionar.

Se você desinstalar uma instância de uma extensão, todos os recursos criados especificamente pelo Firebase para o funcionamento da instância da extensão (como um conjunto de funções) serão excluídos. No entanto, os itens a seguir não são excluídos:

  • Todos os artefatos criados pela extensão (como imagens armazenadas).

  • Todos os outros recursos no projeto, como uma instância de banco de dados ou um bucket do .Cloud Storage Mesmo que a extensão tenha interagido com esses outros recursos, eles não são específicos da extensão. Portanto, não serão excluídos se a extensão for desinstalada.

Como usar o console Firebase, a CLI Firebase ou SDKs gerados automaticamente {: #console-vs-cli}

É possível instalar e gerenciar extensões usando o console do Firebase ou a CLI do Firebase, ou no código usando SDKs gerados automaticamente.

Ação Console Firebase CLI Firebase SDK gerado automaticamente
Visualizar informações detalhadas (pré-instalação)
Instalar
Visualizar configuração (pós-instalação)
Editar configuração
Atualizar versão
Desinstalar

Próximas etapas