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 é desativado, e todos os dados restantes são excluídos permanentemente e não podem ser recuperados.

Escolher seu caminho de migração

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

Migrar para o Google Antigravity

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 seu app usando um modelo integrado ou um repositório importado em 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
• Começou no modo Prototyper, mas adicionou recursos significativos ou scripts de execução que exigem um ambiente local sem limitações da nuvem

Migrar para Google AI Studio

Para um ambiente de prototipagem baseado na Web que traz o poder da IA para seu navegador, recomendamos migrar para Google AI Studio. Ele oferece o caminho mais rápido do comando ao app de produção full-stack. 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

Migrar apps para Google AI Studio

Google AI Studio oferece o caminho mais rápido do comando ao app de produção full-stack.

Etapa 1: transferir seu espaço de trabalho

1. Clique no botão Mover agora na parte de cima do espaço de trabalho e selecione Preparar para o AI Studio.
2. Depois que a etapa de preparação for concluída, clique em Mover para Google AI Studio.
3. Se solicitado, leia e aceite os Termos de Serviço. Seu código será aberto automaticamente em um novo Google AI Studio espaço de trabalho.

Pode levar vários minutos para Google AI Studio converter e carregar seu app. Você vai receber uma notificação quando terminar. Quando terminar, você poderá continuar iterando no app com a ajuda do agente Google AI Studio. Saiba mais sobre como criar apps em Google AI Studio.

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

Dependendo das suas necessidades de implantação e se você quer preservar o URL do aplicativo atual, selecione um dos seguintes métodos de publicação.

Opção A: publicar em App Hosting e manter o URL atual

Se você já publicou seu app pelo Firebase Studio e quer manter o URL *.hosted.app ou o domínio personalizado, proteja sua chave da API Gemini e use a sincronização do GitHub:

1. Proteja sua chave da API Gemini:

   1. No console do Firebase, acesse a App Hosting página.
   2. Encontre o back-end atual (geralmente chamado de studio) e clique em Visualizar.
   3. Na guia Configurações, navegue até Ambiente.

   4. Clique em Adicionar novo e cole o conteúdo do arquivo .env no campo Chave para armazenar com segurança sua chave de API Gemini como uma variável de ambiente.

2. Sincronize com o GitHub no Google AI Studio:

   1. No Google AI Studio, clique no ícone Configurações e navegue até o painel GitHub.
   2. Clique em Fazer login no GitHub e instale o Google AI Studio GitHub App.

   3. Clique em Criar repositório do GitHub.

   4. Selecione Preparar e confirmar todas as mudanças.

3. Conecte o repositório ao App Hosting:

   1. No console do Firebase, acesse a App Hosting página.
   2. Encontre o back-end atual (geralmente chamado de studio) e clique em Visualizar.
   3. Na guia Configurações, selecione Implantação > Conectar ao GitHub.
   4. Faça login no GitHub e instale o app do GitHub Firebase App Hosting.
   5. Selecione seu repositório, defina a ramificação como main e o diretório raiz como /.
   6. Clique em Salvar e implantar.

4. Sincronize as mudanças com o GitHub e implante:

   1. Em Google AI Studio, navegue até o painel do GitHub.
   2. Revise as mudanças a serem publicadas.
   3. Clique em Preparar e confirmar todas as mudanças.
   4. Navegue até o Firebase console para monitorar o progresso da App Hosting implantação.

Opção B: migrar para Cloud Run e publicar seu app em um novo URL

Se você prefere uma experiência de um clique e não publicou seu app antes ou não se importa com um novo URL (*.run.app), use o botão Publicar em Google AI Studio:

1. Abra seu app em Google AI Studio e clique em Publicar.
2. No seletor de projetos, clique em Importar projeto.
3. Pesquise e selecione o nome do projeto usado pelo Firebase Studio (encontrado na barra de navegação superior do seu Firebase Studio espaço de trabalho).
4. Clique em Importar e depois em Publicar.

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

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:

1. No Antigravity, navegue até o menu Executar e depurar, localizado na barra lateral esquerda.
2. Clique no botão de reprodução para iniciar o servidor de desenvolvimento local.
3. 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.

1. No painel de chat, insira o seguinte comando:

   Publish my app
   

2. 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.

3. 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:

1. Clique no botão Mover agora na parte de cima do espaço de trabalho > Compactar e fazer o download.
2. 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 para o App Prototyping agent e o Gemini em Firebase agentes no seu espaço de trabalho no diretório /home/user/.idx/ai do seu Firebase Studio espaço de trabalho.Gemini Isso inclui comandos e respostas de todos os Gemini modos de conversa.

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

1. Selecione Arquivo > Abrir pasta.
2. Aceite o diretório padrão /home/user.
3. Depois que os arquivos carregarem, clique com o botão direito do mouse no diretório .idx/ai e selecione Compactar e baixar.
4. Quando for solicitado que recrie o ambiente, clique em Cancelar.
5. 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 sessões Prototyper, também é possível visualizar seus comandos como parte do registro git. Saiba como encontrá-los:

1. Abra a visualização Código ().

2. 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 baixar 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.

Onde posso encontrar os apps que migrei para o Google AI Studio?

A página Seus apps oferece uma lista unificada de todos os seus projetos, incluindo aqueles criados do zero em Google AI Studio e os que você migrou.

Firebase Authentication com o Login do Google não funciona após a migração para Google AI Studio.

Se o app usa o Login do Google, você precisa autorizar o novo domínio do projeto.

1. No console do Firebase, acesse a página de configurações do Authentication.
2. Clique em Domínios autorizados.
3. Clique em Adicionar domínio e adicione o domínio do seu Google AI Studio app.

O que devo fazer se o agente Google AI Studio parar de funcionar ou se eu encontrar erros em Google AI Studio após a migração?

Como o agente Google AI Studio gerencia tarefas complexas em segundo plano ao migrar seu app, ele pode ocasionalmente encontrar problemas como "tarefa cancelada", mensagens repetidas ou linhas de execução sem resposta.

• Se o agente parar no meio da tarefa sem um erro claro, dar um comando como "Continue de onde parou" ou "Tente a última etapa novamente" geralmente inicia o processo.
• Se você receber uma mensagem informando que houve erros ao executar o código, clique no botão Corrigir para pedir ao agente que os resolva automaticamente.

O que acontece 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 logs 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.

1. Abra o arquivo ~/.bash_profile no Antigravity.

2. Adicione o seguinte bloco de código ao arquivo.

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

3. Salve o arquivo.

4. Reinicie o Antigravity.

Outros recursos

• Conheça o codelab de migração do Firebase Studio para o Antigravity.
• Consulte a documentação do Antigravity.
• Explore a documentação Google AI Studio.

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.