Visão geral

As Extensões do Firebase ajudam a reduzir o tempo gasto no desenvolvimento, na manutenção e no crescimento do seu aplicativo.

Quando você encontrar uma Extensão do Firebase 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). 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, se o uso exceder o nível sem custos dos serviços.

Também é possível avaliar as extensões antes de instalá-las em um projeto usando o emulador de extensões, um componente do Pacote de emuladores locais do Firebase.

Extensões oficiais do Firebase

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

Procurar extensões oficiais do Firebase

Procure extensões oficiais do Firebase das seguintes fontes:

• Página do produto Extensões do Firebase

• Painel Extensões do Firebase no Console do Firebase

Extensões de parceiros com acesso antecipado

As extensões de parceiros com acesso antecipado são desenvolvidas por participantes do programa de acesso antecipado dos editores de extensões. Elas não são criadas nem testadas pelo Google. As extensões de parceiros com acesso antecipado são fornecidas "NO ESTADO EM QUE SE ENCONTRAM" sem garantia expressa ou implícita do Google. O Google se isenta de qualquer responsabilidade por eventuais danos, diretos ou indiretos, decorrentes do uso da extensão.

Para saber mais sobre como publicar sua própria extensão, inscreva-se no programa de acesso antecipado dos editores de extensões.

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

Para encontrar um link para o código-fonte de uma das extensões oficiais do Firebase, clique em Saiba mais no cartão da extensão na página do produto ou no Console do Firebase.

Para encontrar um link para o código-fonte de uma extensão de parceiro com acesso antecipado, inicie o fluxo de instalação usando o link de instalação do console da extensão ou com o comando ext:install da CLI. O link para o código-fonte é exibido junto com outras informações sobre a extensão. Cancele a instalação se quiser apenas examinar o código fonte.

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 do Firebase ou a CLI do Firebase

É possível instalar e gerenciar qualquer uma das extensões oficiais do Firebase usando o Console do Firebase ou a CLI do Firebase.

Próximas etapas

• Veja informações detalhadas sobre uma extensão antes de instalá-la (página do produto Extensões do Firebase ou CLI do Firebase).

• Instale uma extensão no seu projeto do Firebase usando o Console do Firebase ou a CLI do Firebase.