Descontinuação do Firebase Studio e migração de projetos

O Firebase Studio será desativado em 22 de março de 2027. Estamos simplificando nossas ofertas para desenvolvedores de IA ao transferir as lições aprendidas na prévia do Firebase Studio para nossas ferramentas principais: Google AI Studio e Google Antigravity.

Embora a interface para criar apps esteja evoluindo, nosso compromisso com o ecossistema do Firebase está mais forte do que nunca. Ao integrar recursos de agentes diretamente às nossas principais plataformas de IA, garantimos que o Firebase continue oferecendo um back-end confiável e integrado para desenvolvimento orientado por IA. Os principais serviços do Firebase, como Cloud Firestore, Authentication e App Hosting, vão continuar funcionando fora do Firebase Studio.

Por que estamos fazendo essa mudança?

O Firebase Studio foi lançado como uma prévia para explorar o futuro do desenvolvimento full-stack baseado em IA. Com base no seu feedback, estamos simplificando nossas ferramentas para oferecer caminhos mais claros e eficientes:

Para desenvolvimento agêntico com foco no código: estamos focando no Antigravity, nosso IDE de última geração projetado para fluxos de trabalho locais autônomos e de alta velocidade.
Para prototipagem rápida baseada em navegador: integramos o Cloud Firestore e o Firebase Authentication diretamente ao Google AI Studio para oferecer o caminho mais rápido do comando à produção.

Seus serviços principais do Firebase (Cloud Firestore, Authentication, App Hosting, etc.) não são afetados. Seus bancos de dados e dados do usuário vão continuar funcionando normalmente. Essa descontinuação só se aplica ao ambiente de desenvolvimento do Firebase Studio.

Linha do tempo da desativação

Estamos oferecendo um período de transição de um ano para garantir que você tenha tempo suficiente para migrar seus projetos:

19 de março de 2026: anúncio da desativação e início do lançamento das ferramentas de migração para Firebase Studio.
22 de junho de 2026: a criação de novos espaços de trabalho será desativada. Você pode continuar trabalhando e migrando os espaços de trabalho atuais.
22 de março de 2027: o Firebase Studio será desativado, e todos os dados restantes serão excluídos permanentemente e não poderão ser recuperados.

Escolher seu caminho de migração

Dependendo de como você usa o Firebase Studio, escolha o caminho de migração que melhor se adapta ao seu fluxo de trabalho.

Migrar para o Google Antigravity (disponível agora)

Para uma experiência de desenvolvimento com prioridade ao código e baseada em agentes, recomendamos migrar para o Antigravity. É nossa próxima geração de IDEs, projetada para fluxos de trabalho locais autônomos e de alta velocidade. Escolha Antigravity se você atender a um dos seguintes critérios:

Prefere trabalhar em um ambiente de desenvolvimento local, com prioridade para o código e maior controle sobre sua base de código
Criou o app usando um modelo integrado ou um repositório importado no Firebase Studio
Use principalmente o ambiente da Visualização de código em Firebase Studio
Quer acesso direto aos recursos de desenvolvimento de IA generativa mais modernos em uma IDE avançada, com suporte para usar diferentes modelos, como Claude e GPT-OSS, além de Gemini
Início: Prototyper mode, but added significant features or execution scripts that require a local environment without cloud limitations

Migrar para Google AI Studio (em breve)

Ainda estamos trabalhando no pipeline de migração para Google AI Studio para garantir que ele funcione de maneira confiável. Quando estiver disponível, escolha Google AI Studio se você atender a um dos seguintes critérios:

Prefere uma experiência baseada na Web, ideal para fluxos de trabalho multidispositivo ou ambientes em que não é possível instalar software local
Criou seu app usando o App Prototyping agent em Firebase Studio e valoriza a prototipagem rápida e a geração de apps com base em comandos
Quer o caminho mais rápido do comando ao app de produção full-stack

Confira em breve as instruções de migração para o Google AI Studio.

Migrar apps para o Antigravity

O Antigravity é um ambiente de desenvolvimento integrado local que prioriza agentes e traz o poder da IA para seu ambiente de desenvolvimento local.

Pré-requisitos

Verifique se você tem os seguintes recursos instalados localmente e totalmente atualizados:

IDE do Google Antigravity
Node.js (versão 20 ou mais recente)
CLI Firebase (versão 15.10.0 ou mais recente)

Etapa 1: exportar e inicializar o app

Migração automatizada

Esse fluxo de trabalho usa o agente Antigravity para processar de forma autônoma a transformação do projeto.

Em Firebase Studio, clique no botão Mover agora na parte de cima do espaço de trabalho.
Siga o método de exportação com base na janela que aparece:
- Se aparecer um botão Compactar e fazer o download, clique nele.
- Caso contrário, abra a paleta de comandos (Cmd+Shift+P no Mac ou Ctrl+Shift+P no ChromeOS, Windows ou Linux) e execute o comando Firebase Studio: Zip & Download.
Dica: se a janela de download não aparecer, verifique a barra de endereços do navegador para encontrar um ícone de bloqueador de pop-ups e confira se eles estão permitidos.
Extraia a pasta localmente e abra no Antigravity.
No painel Agente do Antigravity, insira o seguinte comando. Para otimizar seu fluxo de trabalho e economizar tokens, recomendamos selecionar o modelo Gemini Flash. Ele foi projetado para oferecer velocidade e eficiência em tarefas de transformação de alto volume, como conversão de arquivos.
```
@fbs-to-agy-export
```
O agente do Antigravity vai iniciar a migração do projeto e pedir sua ajuda ao longo do processo. Siga as orientações do agente para concluir o processo de migração. Se você encontrar algum erro, peça para o agente tentar de novo.

Exportação manual

Se você preferir gerenciar a migração por conta própria sem usar tokens de IA, use a CLI Firebase para exportar seu projeto manualmente. Esse método é direto e não exige interação do agente.

Abra o terminal e execute o seguinte comando, substituindo PATH pelo caminho da pasta do projeto extraído ou do arquivo ZIP original (use . se você já estiver no diretório de destino):

npx firebase-tools@latest studio:export PATH

Etapa 2: visualizar o app

Depois de extrair e abrir o projeto no Antigravity, você pode visualizar o aplicativo localmente:

No Antigravity, navegue até o menu Executar e depurar, localizado na barra lateral esquerda.
Clique no botão de reprodução para iniciar o servidor de desenvolvimento local.
Siga as instruções no terminal para visualizar o app.

Etapa 3: publicar o app

O Antigravity usa habilidades de agente para publicar seu app com as práticas recomendadas do Firebase.

No painel de chat, insira o seguinte comando:
```
Publish my app
```
Quando for solicitado a executar firebase deploy, escolha Sim. O agente será publicado no seu URL atual se você já tiver publicado em Firebase App Hosting. Se esta for a primeira vez que você publica no App Hosting, o agente vai explicar o processo.
Para atualizações futuras, instrua o agente a publish my app no painel de chat do Antigravity.

Migrar apps para outras plataformas

Se preferir mover seu projeto para um ambiente de desenvolvimento ou plataforma de hospedagem diferente, exporte o código-fonte e gerencie as implantações manualmente.

Etapa 1: exportar a origem do projeto

Antes da data de desativação, baixe uma cópia local dos arquivos do projeto:

Clique no botão Mover agora na parte de cima do espaço de trabalho > Compactar e fazer o download.
Extraia o arquivo para sua máquina local.

Etapa 2: escolha seu método de publicação

Depois que o código estiver local, você poderá continuar disponibilizando o app usando os seguintes métodos:

CLI Firebase (mantém seu URL atual)
1. Instale a CLI do Firebase usando npm executando o seguinte comando:
```
npm install -g firebase-tools
```
2. Navegue até o diretório do projeto no terminal.
3. Execute este comando para configurar implantações do App Hosting no seu projeto local:
```
firebase init apphosting
```
4. Quando solicitado, selecione Vincular a um back-end atual e escolha o back-end chamado studio. Isso garante que o URL do app permaneça o mesmo.
5. Siga as instruções para concluir a configuração. Sua configuração App Hosting será adicionada a firebase.json.
6. Implante o aplicativo:
```
firebase deploy
```
Hospedagem externa:como o código exportado é um aplicativo da Web padrão, é possível inicializá-lo com qualquer provedor de hospedagem. Observe que a transferência para um provedor externo resultará em um novo URL.
Somente desenvolvimento local:você pode continuar desenvolvendo e testando seu app localmente usando o Firebase Local Emulator Suite para testes off-line mais rápidos sem implantação em um ambiente ativo.

Solução de problemas e perguntas frequentes

Confira as perguntas frequentes e as etapas de solução de problemas para migrar seus projetos do Firebase Studio.

Posso continuar usando Firebase Studio até a desativação?

Sim, você pode acessar os espaços de trabalho atuais até 22 de março de 2027. Vamos continuar oferecendo patches de segurança críticos e atualizações do modelo Gemini para garantir a estabilidade dos seus projetos atuais. A criação de novos espaços de trabalho será desativada a partir de 22 de junho de 2026.

Meu histórico de chat do agente será migrado?

O histórico de chat do seu agente não faz parte do arquivo ZIP exportado. No entanto, é possível localizar os arquivos do histórico de chat do Gemini para os agentes App Prototyping agent e Gemini no Firebase no seu espaço de trabalho no diretório /home/user/.idx/ai do seu espaço de trabalho do Firebase Studio. Isso inclui comandos e respostas de todos os modos de conversa do Gemini.

Saiba como criar um arquivo ZIP com seu histórico:

Selecione Arquivo > Abrir pasta.
Aceite o diretório padrão /home/user.
Depois que os arquivos carregarem, clique com o botão direito do mouse no diretório .idx/ai e selecione Compactar e baixar.
Quando for solicitado que recrie o ambiente, clique em Cancelar.
Depois de concluir a transferência, abra novamente o diretório de trabalho pelo menu Arquivo para voltar ao seu espaço de trabalho.

Para Prototyper sessions, you can also view your prompts as part of the git log. Here's how to locate them:

Abra a visualização Código ().
Faça uma das seguintes ações:
- Abra uma sessão do terminal (Cmd-Shift-C no Mac ou Ctrl-Shift-C no ChromeOS, Windows ou Linux) e digite git log.
- Abra Controle de origem (Cmd+Shift+G no Mac ou Ctrl-Shift+G no ChromeOS, Windows ou Linux) e confira o histórico de origem.

Tentei compactar e baixar meus arquivos em Firebase Studio, mas nada aconteceu.

Isso geralmente é causado por um bloqueador de pop-ups do navegador. Como o fluxo de migração abre uma nova interface para processar sua solicitação, alguns navegadores podem sinalizá-la como um pop-up indesejado.

Para corrigir isso, procure uma notificação "Pop-up bloqueado" na barra de endereço do navegador (geralmente no lado direito). Clique no ícone e selecione a opção para permitir pop-ups. Depois, tente clicar no botão novamente.

Se isso não funcionar, siga as instruções em Como faço o download dos meus arquivos do Firebase Studio? para executar o comando Compactar e fazer o download manualmente.

Posso migrar os espaços de trabalho Firebase Studio que foram compartilhados comigo?

Somente a pessoa que criou o espaço de trabalho Firebase Studio pode usar o botão Mover agora. Se quiser uma cópia do projeto, faça uma destas ações:

Duplicar o espaço de trabalho: crie uma cópia do projeto na sua conta para vincular a seu próprio projeto do Firebase e usar as ferramentas de migração.
Exportar o código manualmente:na Visualização de código, abra a paleta de comandos (Cmd+Shift+P no Mac ou Ctrl+Shift+P no ChromeOS, Windows ou Linux) e execute o comando Firebase Studio: compactar e fazer o download.

E se a exportação ficar parada ou expirar?

Se o processo de migração ficar suspenso durante a preparação dos arquivos, geralmente isso ocorre devido a uma pasta de projeto muito grande.

Para abrir caminho para uma migração bem-sucedida:

Excluir node_modules:como parte do processo de migração, essa pasta geralmente é removida. No entanto, se você renomeou ou moveu o arquivo, ou planeja compactar e baixar o código manualmente, exclua-o antes de iniciar a migração. Não é necessário migrar essa pasta porque você pode executar npm install depois de mudar para o novo ambiente.
Remova artefatos grandes:exclua arquivos de mídia grandes, exportações de banco de dados ou pastas de build que não são estritamente necessárias para o código-fonte.
Verifique se há "bloqueio" oculto:confira se você não está compactando acidentalmente um histórico enorme do .git ou registros locais.

Depois de excluir os arquivos grandes, tente migrar o projeto novamente.

Por que meus comandos da CLI Firebase ou `npx` estão falhando no terminal do Antigravity?

Se você encontrar erros de "comando não encontrado" ou problemas ao executar comandos npx no Antigravity, mesmo que eles funcionem no terminal padrão do sistema, isso provavelmente se deve à forma como o ambiente de shell está sendo inicializado.

O ambiente de terminal do Antigravity procura configurações no seu ~/.bash_profile. Muitos desenvolvedores armazenam as configurações de npx e caminho em ~/.bashrc. Se essas configurações não forem compartilhadas, o Antigravity não saberá onde encontrar suas ferramentas.

Para corrigir isso, adicione o arquivo .bashrc ao .bash_profile. Isso garante que todas as configurações atuais sejam carregadas sempre que o Antigravity for iniciado.

Abra o arquivo ~/.bash_profile no Antigravity.

Adicione o seguinte bloco de código ao arquivo:

if [ -f ~/.bashrc ]; then
    source ~/.bashrc
fi

Salve o arquivo.
Reinicie o Antigravity.

Precisa de ajuda?

Se você tiver dúvidas, feedback ou encontrar problemas ao migrar seus projetos, entre em contato em um dos seguintes lugares:

Entre em contato com o suporte do Firebase.
Poste no Firebase Studio Fórum da comunidade.