Завершение работы Firebase Studio и миграция проекта.

Firebase Studio is sunsetting on March 22, 2027 . We're simplifying our AI developer offerings by transitioning the lessons learned from the Firebase Studio preview into our flagship tools: Google AI Studio and Google Antigravity .

Хотя интерфейс для создания приложений постоянно развивается, наша приверженность экосистеме Firebase сильна как никогда. Интегрируя возможности агентов непосредственно в наши флагманские платформы ИИ, мы гарантируем, что Firebase продолжит предоставлять бесперебойную и надежную серверную часть для разработки на основе ИИ. Основные сервисы Firebase, такие как Cloud Firestore , Authentication и App Hosting , будут по-прежнему работать вне Firebase Studio .

Почему мы вносим эти изменения

Firebase Studio launched as a preview to explore the future of AI-driven, full-stack development. Based on your feedback, we're streamlining our tools to provide clearer, more powerful paths forward:

• For code-first, agentic development : We're focusing on Antigravity , our next-generation IDE designed for high-velocity, autonomous local workflows.

• For rapid, browser-based prototyping : We've integrated Cloud Firestore and Firebase Authentication directly into Google AI Studio to provide the fastest path from prompt to production.

Your core Firebase services ( Cloud Firestore , Authentication , App Hosting , etc.) are not affected. Your databases and user data will continue to function normally. This sunset only applies to the Firebase Studio development environment.

Хронология заката

We're providing a one-year transition period to ensure you have ample time to migrate your projects:

• March 19, 2026 : Sunset announcement, and migration tools start rolling out to Firebase Studio .
• June 22, 2026 : New workspace creation is disabled. You can continue to work in and migrate existing workspaces.
• March 22, 2027 : Firebase Studio is shut down, and all remaining data is permanently deleted and cannot be recovered.

Выберите путь миграции

Depending on how you use Firebase Studio , choose the migration path that best fits your workflow.

Переход на Google Antigravity

For a code-first, agentic development experience, we recommend migrating to Antigravity . This is our next-generation IDE designed for high-velocity, autonomous local workflows. You should choose Antigravity if you meet any of the following criteria:

• Prefer working in a local, code-first development environment with deeper control over your codebase
• Вы создали приложение, используя встроенный шаблон или импортированный репозиторий в Firebase Studio
• В основном используйте среду просмотра кода в Firebase Studio
• Want direct access to state-of-the-art agentic AI development capabilities within a powerful IDE, with support for using different models like Claude and GPT-OSS, in addition to Gemini
• Начиналось всё в Prototyper mode, but added significant features or execution scripts that require a local environment without cloud limitations

Переход на Google AI Studio

For a web-based prototyping environment that brings the power of AI into your browser, we recommend migrating to Google AI Studio . It offers the fastest path from prompt to full-stack production app. You should choose Google AI Studio if you meet any of the following criteria:

• Предпочтительнее использовать веб-интерфейс, который идеально подходит для работы на нескольких устройствах или в средах, где невозможно установить локальное программное обеспечение.
• Created your app using the the App Prototyping agent in Firebase Studio and value rapid prototyping and prompt-based app generation
• Хотите максимально быстро пройти путь от командной строки до полноценного рабочего приложения?

Перенос приложений в Google AI Studio

Google AI Studio offers the fastest path from prompt to full-stack production app.

Шаг 1: Перенесите свое рабочее место.

1. Нажмите кнопку «Переместить сейчас» в верхней части рабочей области, затем выберите «Подготовить к работе с AI Studio» .
2. After the preparation step is complete, click Move to Google AI Studio .
3. При необходимости ознакомьтесь с Условиями предоставления услуг и примите их. Ваш код автоматически откроется в новом рабочем пространстве Google AI Studio .

It may take several minutes for Google AI Studio to convert and load your app. It will notify you when it's complete. When finished, you can continue iterating on your app with help from the Google AI Studio agent. Learn more about building apps in Google AI Studio .

Шаг 2: Выберите способ публикации

В зависимости от ваших потребностей в развертывании и от того, хотите ли вы сохранить существующий URL-адрес приложения, выберите один из следующих способов публикации.

Вариант А: Опубликовать на App Hosting и сохранить существующий URL-адрес.

Если вы ранее опубликовали свое приложение через Firebase Studio и хотите сохранить URL-адрес *.hosted.app или собственный домен, защитите свой API-ключ Gemini и используйте GitHub Sync:

1. Защитите свой API-ключ Gemini:
   1. В консоли Firebase перейдите на страницу App Hosting .
   2. Найдите свою существующую панель управления (обычно она называется studio ) и нажмите «Просмотреть» .
   3. На вкладке «Настройки» перейдите в раздел «Окружающая среда» .
   4. Нажмите «Добавить новый» и вставьте содержимое вашего файла .env в поле «Ключ» , чтобы безопасно сохранить ваш ключ API Gemini в качестве переменной среды.

2. Синхронизация с GitHub из Google AI Studio :

   1. В Google AI Studio нажмите на значок «Настройки» и перейдите в панель GitHub .
   2. Нажмите «Войти в GitHub» и установите приложение Google AI Studio для GitHub.

   3. Click Create GitHub repository .

   4. Выберите этап и подтвердите все изменения .

3. Подключите репозиторий к App Hosting :

   1. В консоли Firebase перейдите на страницу App Hosting .
   2. Найдите свою существующую панель управления (обычно она называется studio ) и нажмите «Просмотреть» .
   3. На вкладке «Настройки» выберите «Развертывание» > «Подключиться к GitHub» .
   4. Войдите в GitHub и установите Firebase App Hosting GitHub App.
   5. Выберите свой репозиторий, укажите ветку main , а корневой каталог — / .
   6. Нажмите «Сохранить и развернуть» .

4. Синхронизируйте изменения с GitHub и выполните развертывание:

   1. В Google AI Studio перейдите на панель GitHub .
   2. Ознакомьтесь с изменениями, которые будут опубликованы.
   3. Нажмите «Этап» и подтвердите все изменения .
   4. Перейдите в консоль Firebase , чтобы отслеживать ход развертывания App Hosting .

Вариант B: Перейдите на Cloud Run и опубликуйте приложение по новому URL-адресу.

Если вы предпочитаете публикацию в один клик и либо ранее не публиковали свое приложение, либо вас не смущает новый URL-адрес ( *.run.app ), используйте кнопку «Опубликовать» в Google AI Studio :

1. Откройте свое приложение в Google AI Studio и нажмите «Опубликовать» .
2. В окне выбора проекта нажмите «Импорт проекта» .
3. Найдите и выберите название проекта, используемого Firebase Studio (его можно найти в верхней панели навигации вашей рабочей области Firebase Studio ).
4. Нажмите «Импорт» , а затем « Опубликовать» .

Перенесите приложения на Antigravity.

Antigravity — это локальная IDE, ориентированная на агентов, которая переносит возможности искусственного интеллекта в вашу локальную среду разработки.

Предварительные требования

Убедитесь, что у вас локально установлены и полностью обновлены следующие компоненты:

• Google Antigravity IDE
• Node.js (версия 20 или выше)
• Firebase CLI (версия 15.10.0 или выше)

Шаг 1: Экспортируйте и инициализируйте ваше приложение.

npx firebase-tools@latest studio:export PATH

Шаг 2: Предварительный просмотр вашего приложения

После того как вы распакуете свой проект и откроете его в Antigravity, вы сможете просмотреть свое приложение локально:

1. В Antigravity перейдите в меню «Запуск и отладка», расположенное в левой боковой панели.
2. Нажмите кнопку воспроизведения, чтобы запустить локальный сервер разработки.
3. Следуйте инструкциям в терминале, чтобы просмотреть ваше приложение.

Шаг 3: Опубликуйте свое приложение

Antigravity использует навыки агентов для публикации вашего приложения в соответствии с лучшими практиками Firebase.

1. В панели чата введите следующую команду:

   Publish my app
   

2. When prompted to run firebase deploy , choose Yes . The agent will publish to your existing URL if you've previously published to Firebase App Hosting . If this is your first time publishing to App Hosting , the agent will walk you through the process.

3. Для получения будущих обновлений поручите агенту publish my app в чате Antigravity.

Migrate apps to other platforms

Если вы предпочитаете перенести свой проект в другую среду разработки или на другую хостинговую платформу, вы можете экспортировать исходный код и управлять развертыванием вручную.

Step 1: Export your project source

До истечения срока действия необходимо загрузить локальную копию файлов проекта:

1. Нажмите кнопку «Переместить сейчас» в верхней части рабочего пространства > «Заархивировать и загрузить» .
2. Распакуйте архив на свой локальный компьютер.

Step 2: Choose your publishing method

После того как ваш код будет локализован, вы можете продолжить запуск приложения, используя следующие методы:

• Firebase CLI (сохраняет существующий URL)

  1. Установите Firebase CLI с помощью npm , выполнив следующую команду:

     npm install -g firebase-tools
     

  2. Перейдите в каталог вашего проекта в терминале.

  3. Выполните эту команду, чтобы настроить развертывание App Hosting для вашего локального проекта:

     firebase init apphosting
     

  4. При появлении запроса выберите «Привязать к существующей административной панели» и выберите панель с именем studio . Это гарантирует, что URL-адрес вашего приложения останется неизменным.

  5. Следуйте инструкциям для завершения настройки. Настройки App Hosting будут добавлены в firebase.json .

  6. Deploy the application:

     firebase deploy
     

• Внешний хостинг: Поскольку экспортированный вами код представляет собой стандартное веб-приложение, вы можете инициализировать его у любого хостинг-провайдера. Обратите внимание, что переход к внешнему провайдеру приведет к созданию нового URL-адреса.

• Только для локальной разработки: вы можете продолжать разрабатывать и тестировать свое приложение локально, используя Firebase Local Emulator Suite для более быстрого тестирования в автономном режиме без развертывания в рабочей среде.

Устранение неполадок и часто задаваемые вопросы

Ознакомьтесь с приведенными ниже часто задаваемыми вопросами и шагами по устранению неполадок при миграции проектов Firebase Studio .

Могу ли я продолжать использовать Firebase Studio до тех пор, пока не будет прекращена его поддержка?

Yes, you can access existing workspaces until March 22, 2027 . We'll continue to provide critical security patches and Gemini model updates to ensure your current projects remain stable. Note that new workspace creation will be disabled starting June 22, 2026.

Will my agent chat history be migrated?

Your agent chat history isn't part of the current exported zip file. However, you can locate Gemini chat history files for the the App Prototyping agent and Gemini in Firebase agents within your workspace in the /home/user/.idx/ai directory of your Firebase Studio workspace. This contains prompts and responses from all Gemini chat modes.

Вот как создать ZIP-архив, содержащий вашу историю:

1. Select File > Open Folder .
2. Accept the default /home/user directory.
3. После загрузки файлов щелкните правой кнопкой мыши по папке .idx/ai и выберите «Заархивировать и загрузить» .
4. Когда появится запрос на пересоздание среды, нажмите «Отмена» .
5. После завершения загрузки откройте свою рабочую директорию из меню «Файл» , чтобы вернуться в рабочее пространство.

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

1. Open Code view ( ).

2. Perform either of the following:

   • Откройте терминал ( Cmd-Shift-C на Mac или Ctrl-Shift-C на ChromeOS, Windows или Linux) и введите git log .
   • Откройте систему контроля версий ( Cmd+Shift+G на Mac или Ctrl-Shift+G на ChromeOS, Windows или Linux) и просмотрите историю изменений исходного кода.

Я попытался заархивировать и загрузить свои файлы в Firebase Studio , но ничего не произошло.

Обычно это происходит из-за блокировщика всплывающих окон в браузере. Поскольку процесс миграции открывает новый интерфейс для обработки вашего запроса, некоторые браузеры могут пометить его как нежелательное всплывающее окно.

To fix this, look for a "Pop-up blocked" notification in your browser's address bar (usually on the right side). Click the icon and select the option to allow pop-ups, and then try clicking the button again.

Если это не сработает, воспользуйтесь инструкциями в разделе «Как загрузить файлы из Firebase Studio ?» , чтобы запустить команды Zip и Download вручную.

Могу ли я перенести рабочие пространства Firebase Studio , которыми со мной поделились?

Кнопку «Переместить сейчас» может использовать только тот, кто создал рабочую область Firebase Studio . Если вы хотите получить копию проекта, вы можете сделать одно из следующих действий:

• Дублирование рабочего пространства : Создайте копию проекта в своей учетной записи, что позволит вам связать ее с вашим собственным проектом Firebase и использовать инструменты миграции.
• Manually export your code: From Code view , you can open the command palette ( Cmd + Shift + P on Mac or Ctrl + Shift + P on ChromeOS, Windows, or Linux) and run the Firebase Studio : Zip & Download command.

Где я могу найти приложения, которые я перенёс в Google AI Studio ?

На странице «Ваши приложения» представлен единый список всех ваших проектов, включая те, которые были созданы с нуля в Google AI Studio , а также те, которые вы перенесли.

После перехода на Google AI Studio Firebase Authentication с использованием Google Sign-In перестала работать.

Если ваше приложение использует авторизацию через Google, вам необходимо авторизовать новый домен вашего проекта.

1. В консоли Firebase перейдите на страницу настроек Authentication .
2. Click Authorized domains .
3. Нажмите «Добавить домен» и добавьте домен вашего приложения Google AI Studio .

Что мне делать, если агент Google AI Studio перестанет работать или я увижу ошибки в Google AI Studio после миграции?

Because the Google AI Studio agent manages complex background tasks while migrating your app, the agent can occasionally encounter issues like "task canceled," repeating messages, or unresponsive threads.

• Если агент останавливается посреди выполнения задачи без явной ошибки, часто помогает запустить процесс с помощью подсказки типа «Продолжить с того места, где остановились» или «Попробуйте выполнить последний шаг еще раз».
• Если вы видите сообщение об ошибках при выполнении кода, нажмите кнопку «Исправить» , чтобы агент автоматически их устранил.

What if the export stalls or times out?

Если процесс миграции зависает на этапе подготовки файлов, это часто происходит из-за слишком большого размера папки проекта.

To clear the path for a successful migration:

• Delete node_modules : As part of the migration process, this folder is generally removed. However, if you renamed or moved it, or plan to manually zip and download your code, delete it before initiating the migration. You don't need to migrate this folder because you can run npm install once you've moved to your new environment.
• Удалите крупные артефакты: удалите все большие медиафайлы, экспортированные из базы данных файлы или папки сборки, которые не являются строго необходимыми для исходного кода.
• Проверьте наличие "скрытого" избыточного кода: убедитесь, что вы случайно не архивируете в архив большой объем истории .git или локальных логов.

После удаления всех больших файлов попробуйте снова перенести свой проект.

Почему мои команды Firebase CLI или npx не выполняются в терминале Antigravity?

If you encounter "command not found" errors or issues running npx commands within Antigravity—even though they work in your standard system terminal—it's likely due to how your shell environment is being initialized.

Antigravity's terminal environment looks for configuration settings in your ~/.bash_profile . Many developers have their npx and path configurations stored in ~/.bashrc instead. If these settings aren't shared, Antigravity won't know where to find your tools.

Это можно исправить, добавив команду `source` из файла .bashrc в файл `.bash_profile`. Это гарантирует загрузку всех существующих конфигураций при каждом запуске Antigravity.

1. Open your ~/.bash_profile file in Antigravity.

2. Add the following code block to the file:

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

3. Сохраните файл.

4. Restart Antigravity.

Другие ресурсы

• Попробуйте пройти обучающий семинар по миграции Firebase Studio в Antigravity .
• Explore the Antigravity documentation .
• Explore the Google AI Studio documentation .

Нужна помощь?

Если у вас возникли вопросы, замечания или проблемы при миграции проектов, свяжитесь с нами одним из следующих способов:

• Contact Firebase Support .
• Post in the Firebase Studio Community Forum .