2027년 3월 22일에 Firebase Studio가 지원 종료됩니다. 앱의 새 버전을 계속 빌드하고 배포하려면 해당 날짜 전에 Firebase Studio 프로젝트를 Google AI Studio 또는 Google Antigravity로 마이그레이션하세요. 마이그레이션 방법 알아보기

Firebase에 이미 배포된 앱은 지원 종료일 이후에도 계속 실행됩니다. 또한 Firestore, 인증, App Hosting 등 모든 핵심 Firebase 제품은 Firebase Studio 지원 종료의 영향을 받지 않습니다.

Firebase Studio 지원 종료 및 프로젝트 마이그레이션

2027년 3월 22일에 Firebase Studio가 지원 종료됩니다. Firebase Studio 프리뷰에서 얻은 교훈을 대표적인 도구인 Google AI Studio 및 Google Antigravity로 전환하여 AI 개발자 제품을 간소화하고 있습니다.

앱 빌드 인터페이스는 계속 발전하고 있지만 Firebase 생태계에 대한 Google의 노력은 그 어느 때보다 확고합니다. 에이전트 기능을 Google의 대표 AI 플랫폼에 직접 통합함으로써 Firebase는 AI 기반 개발을 위한 원활하고 안정적인 백엔드를 계속 제공할 수 있습니다. Cloud Firestore, Authentication, App Hosting과 같은 핵심 Firebase 서비스는 Firebase Studio 외부에서 계속 작동합니다.

이렇게 변경하는 이유

Firebase Studio는 AI 기반 풀 스택 개발의 미래를 탐색하기 위한 프리뷰로 출시되었습니다. Google은 사용자 의견을 바탕으로 명확하고 강력한 진행 방법을 제공하기 위해 도구를 간소화하고 있습니다.

코드 중심 에이전트형 개발: Google은 빠른 속도의 자율 로컬 워크플로를 위해 설계된 차세대 IDE인 Antigravity에 집중하고 있습니다.
신속한 브라우저 기반 프로토타입 제작: 프롬프트에서 프로덕션까지 가장 빠른 경로를 제공하기 위해 Cloud Firestore 및 Firebase Authentication을 Google AI Studio에 직접 통합했습니다.

핵심 Firebase 서비스(Cloud Firestore, Authentication, App Hosting 등)는 영향을 받지 않습니다. 데이터베이스와 사용자 데이터는 계속 정상적으로 작동합니다. 이 지원 종료는 Firebase Studio 개발 환경에만 적용됩니다.

지원 종료 타임라인

프로젝트를 마이그레이션할 충분한 시간을 드릴 수 있도록 1년의 전환 기간을 제공합니다.

2026년 3월 19일: 지원 종료가 공지되고 Firebase Studio에 마이그레이션 도구가 출시됩니다.
2026년 6월 22일: 새 작업공간 생성이 사용 중지됩니다. 기존 작업공간에서 계속 작업하고 기존 작업공간을 마이그레이션할 수 있습니다.
2027년 3월 22일: Firebase Studio가 종료되고 남아 있는 모든 데이터가 영구적으로 삭제되어 복구할 수 없습니다.

마이그레이션 경로 선택

Firebase Studio 사용 방식에 따라 워크플로에 가장 적합한 마이그레이션 경로를 선택하세요.

Google Antigravity로 마이그레이션(지금 사용 가능)

코드 중심의 에이전트 개발 환경을 위해서는 Antigravity로 마이그레이션하는 것이 좋습니다. 이는 빠른 속도의 자율 로컬 워크플로를 위해 설계된 차세대 IDE입니다. 다음 기준 중 하나를 충족하는 경우 Antigravity를 선택해야 합니다.

코드베이스를 더 심층적으로 제어할 수 있는 로컬 코드 중심 개발 환경에서 작업하는 것을 선호하는 경우
Firebase Studio에서 기본 제공 템플릿 또는 가져온 저장소를 사용하여 앱을 만든 경우
Firebase Studio에서 코드 보기 환경을 주로 사용하는 경우
Gemini 외에도 Claude, GPT-OSS와 같은 다양한 모델을 지원하며 강력한 IDE 내에서 최첨단 에이전트 AI 개발 기능에 직접 액세스하고 싶은 경우
Prototyper mode, but added significant features or execution scripts that require a local environment without cloud limitations에서 시작

Google AI Studio로 마이그레이션(제공 예정)

Google에서는 안정적인 작동을 위해 Google AI Studio로의 마이그레이션 파이프라인에 대한 작업을 진행 중입니다. 사용할 수 있게 되면 다음 기준 중 하나를 충족하는 경우 Google AI Studio를 선택해야 합니다.

여러 기기 워크플로 또는 로컬 소프트웨어를 설치할 수 없는 환경에 적합한 웹 기반 환경을 선호
Firebase Studio의 App Prototyping agent을 사용하여 앱을 만들고 빠른 프로토타입 제작과 프롬프트 기반 앱 생성을 중요하게 생각하는 경우
프롬프트에서 풀스택 프로덕션 앱으로의 가장 빠른 경로를 원하는 경우

Google AI Studio 마이그레이션 안내를 나중에 다시 확인해 주세요.

앱을 Antigravity로 마이그레이션

Antigravity는 AI의 기능을 로컬 개발 환경에 제공하는 로컬 에이전트 중심 IDE입니다.

기본 요건

다음이 로컬에 설치되어 있고 최신 상태인지 확인합니다.

Google Antigravity IDE
Node.js(버전 20 이상)
Firebase CLI(버전 15.10.0 이상)

1단계: 앱 내보내기 및 초기화

자동화된 이전

이 워크플로는 Antigravity 에이전트를 사용하여 프로젝트 변환을 자율적으로 처리합니다.

Firebase Studio에서 작업공간 상단의 지금 이동 버튼을 클릭합니다.
표시되는 창에 따라 내보내기 방법을 따르세요.
- 압축 및 다운로드 버튼이 표시되면 클릭합니다.
- 그렇지 않은 경우 명령어 팔레트(Mac의 경우 Cmd+Shift+P, ChromeOS, Windows 또는 Linux의 경우 Ctrl+Shift+P)를 열고 Firebase Studio: Zip & Download 명령어를 실행합니다.
도움말: 다운로드 창이 표시되지 않으면 브라우저의 주소 표시줄에서 팝업 차단기 아이콘을 확인하고 팝업이 허용되어 있는지 확인하세요.
폴더를 로컬로 추출하고 Antigravity에서 엽니다.
Antigravity의 에이전트 창에 다음 프롬프트를 입력합니다. 워크플로를 최적화하고 토큰을 절약하려면 Gemini Flash 모델을 선택하는 것이 좋습니다. 파일 변환과 같은 대량 변환 작업에서 속도와 효율성을 높이도록 설계되었습니다.
```
@fbs-to-agy-export
```
Antigravity 에이전트가 프로젝트 마이그레이션을 시작하고 진행 중에 지원을 요청합니다. 에이전트의 안내에 따라 마이그레이션 절차를 완료합니다. 오류가 발생하면 에이전트에게 다시 시도하라고 프롬프트합니다.

수동 내보내기

AI 토큰을 사용하지 않고 직접 마이그레이션을 관리하려면 Firebase CLI를 사용하여 프로젝트를 수동으로 내보내면 됩니다. 이 방법은 직접적이며 에이전트 상호작용이 필요하지 않습니다.

터미널을 열고 다음 명령어를 실행합니다. 이때 PATH를 추출된 프로젝트 폴더 또는 원래 zip 파일의 경로로 바꿉니다(이미 타겟 디렉터리에 있는 경우 . 사용).

npx firebase-tools@latest studio:export PATH

2단계: 앱 미리보기

프로젝트를 추출하고 Antigravity 내에서 열면 다음과 같이 로컬에서 애플리케이션을 볼 수 있습니다.

Antigravity에서 왼쪽 사이드바에 있는 실행 및 디버그 메뉴로 이동합니다.
재생 버튼을 클릭하여 로컬 개발 서버를 시작합니다.
터미널의 안내에 따라 앱을 미리 봅니다.

3단계: 앱 게시

Antigravity는 에이전트 스킬을 사용하여 Firebase 권장사항에 따라 앱을 게시합니다.

채팅 패널에 다음 프롬프트를 입력합니다.
```
Publish my app
```
firebase deploy를 실행하라는 메시지가 표시되면 예를 선택합니다. 이전에 Firebase App Hosting에 게시한 적이 있는 경우 에이전트가 기존 URL에 게시합니다. App Hosting에 처음 게시하는 경우 에이전트가 절차를 안내해 드립니다.
향후 업데이트를 위해 에이전트에게 Antigravity 채팅 패널에서 publish my app하라고 안내합니다.

앱을 다른 플랫폼으로 마이그레이션

프로젝트를 다른 개발 환경이나 호스팅 플랫폼으로 이동하려면 소스 코드를 내보내고 배포를 수동으로 관리하면 됩니다.

1단계: 프로젝트 소스 내보내기

지원 종료일 전에 프로젝트 파일의 로컬 사본을 다운로드해야 합니다.

작업공간 상단의 지금 이동 버튼 > 압축 및 다운로드를 클릭합니다.
보관 파일을 로컬 머신에 추출합니다.

2단계: 게시 방법 선택

코드가 로컬에 있으면 다음 방법을 사용하여 앱을 계속 제공할 수 있습니다.

Firebase CLI(기존 URL 유지)
1. 다음 명령어를 실행하여 npm을 사용하여 Firebase CLI를 설치합니다.
```
npm install -g firebase-tools
```
2. 터미널에서 프로젝트 디렉터리로 이동합니다.
3. 다음 명령어를 실행하여 로컬 프로젝트의 App Hosting 배포를 설정합니다.
```
firebase init apphosting
```
4. 메시지가 표시되면 기존 백엔드에 연결을 선택하고 studio라는 백엔드를 선택합니다. 이렇게 하면 앱의 URL이 동일하게 유지됩니다.
5. 표시되는 메시지에 따라 설정을 완료합니다. App Hosting 구성이 firebase.json에 추가됩니다.
6. 애플리케이션을 배포합니다.
```
firebase deploy
```
외부 호스팅: 내보낸 코드는 표준 웹 애플리케이션이므로 모든 호스팅 제공업체로 초기화할 수 있습니다. 외부 제공업체로 이동하면 새 URL이 생성됩니다.
로컬 개발만 해당: Firebase Local Emulator Suite을 사용하여 라이브 환경에 배포하지 않고도 오프라인에서 더 빠르게 테스트할 수 있도록 로컬에서 앱을 계속 개발하고 테스트할 수 있습니다.

문제해결 및 FAQ

Firebase Studio 프로젝트를 마이그레이션할 때 발생하는 일반적인 질문과 문제 해결 단계를 검토하세요.

지원 종료될 때까지 Firebase Studio를 계속 사용할 수 있나요?

예, 2027년 3월 22일까지 기존 작업공간에 액세스할 수 있습니다. 현재 프로젝트가 안정적으로 유지되도록 중요한 보안 패치와 Gemini 모델 업데이트를 계속 제공할 예정입니다. 2026년 6월 22일부터 새 작업공간 생성이 사용 중지됩니다.

에이전트 채팅 기록이 마이그레이션되나요?

에이전트 채팅 기록은 현재 내보낸 ZIP 파일에 포함되어 있지 않습니다. 하지만 Firebase Studio 작업공간의 /home/user/.idx/ai 디렉터리에서 App Prototyping agent 및 Firebase의 Gemini 에이전트의 Gemini 채팅 기록 파일을 찾을 수 있습니다. 여기에는 모든 Gemini 채팅 모드의 프롬프트와 대답이 포함됩니다.

기록이 포함된 ZIP 파일을 만드는 방법은 다음과 같습니다.

파일 > 폴더 열기를 선택합니다.
기본 /home/user 디렉터리를 수락합니다.
파일이 로드되면 .idx/ai 디렉터리를 마우스 오른쪽 버튼으로 클릭하고 압축 및 다운로드를 선택합니다.
환경을 다시 빌드하라는 메시지가 표시되면 취소를 클릭합니다.
다운로드가 완료되면 파일 메뉴에서 작업 디렉터리를 다시 열어 작업공간으로 돌아갑니다.

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

코드 뷰()를 엽니다.
다음 중 하나를 수행합니다.
- 터미널 세션(Mac의 경우 Cmd-Shift-C, ChromeOS, Windows 또는 Linux의 경우 Ctrl-Shift-C)을 열고 git log를 입력합니다.
- 소스 제어(Mac의 경우 Cmd+Shift+G, ChromeOS, Windows 또는 Linux의 경우 Ctrl-Shift+G)를 열고 소스 기록을 확인합니다.

Firebase Studio에서 파일을 압축하고 다운로드하려고 했지만 아무 일도 일어나지 않습니다.

이 문제는 일반적으로 브라우저 팝업 차단기로 인해 발생합니다. 마이그레이션 흐름에서 요청을 처리하기 위한 새 인터페이스를 열기 때문에 일부 브라우저에서는 이를 원치 않는 팝업으로 표시할 수 있습니다.

이 문제를 해결하려면 브라우저의 주소 표시줄(일반적으로 오른쪽)에서 '팝업 차단됨' 알림을 찾으세요. 아이콘을 클릭하고 팝업을 허용하는 옵션을 선택한 다음 버튼을 다시 클릭해 보세요.

그래도 해결되지 않으면 Firebase Studio에서 파일을 다운로드하려면 어떻게 해야 하나요?의 안내를 따라 압축 및 다운로드 명령어를 수동으로 실행합니다.

나와 공유된 Firebase Studio 작업공간을 마이그레이션할 수 있나요?

Firebase Studio 작업공간을 만든 사용자만 지금 이동 버튼을 사용할 수 있습니다. 프로젝트 사본이 필요한 경우 다음 중 하나를 수행하면 됩니다.

작업공간 복제: 내 계정으로 프로젝트의 사본을 만들어 내 Firebase 프로젝트에 연결하고 마이그레이션 도구를 사용할 수 있습니다.
코드를 수동으로 내보내기: 코드 보기에서 명령어 팔레트(Mac의 경우 Cmd+Shift+P, ChromeOS, Windows 또는 Linux의 경우 Ctrl+Shift+P)를 열고 Firebase Studio: Zip & Download 명령을 실행합니다.

내보내기가 멈추거나 타임아웃되면 어떻게 해야 하나요?

파일을 준비하는 동안 마이그레이션 프로세스가 중단되는 경우 프로젝트 폴더가 너무 커서인 경우가 많습니다.

성공적인 마이그레이션을 위해 다음 단계를 따르세요.

node_modules 삭제: 이 폴더는 일반적으로 마이그레이션 프로세스의 일부로 삭제됩니다. 하지만 이름을 바꾸거나 이동한 경우 또는 코드를 수동으로 압축하고 다운로드할 계획이라면 마이그레이션을 시작하기 전에 삭제하세요. 새 환경으로 이동한 후 npm install을 실행할 수 있으므로 이 폴더를 마이그레이션할 필요는 없습니다.
대용량 아티팩트 삭제: 소스 코드에 반드시 필요하지 않은 대용량 미디어 파일, 데이터베이스 내보내기 또는 빌드 폴더를 삭제합니다.
'숨겨진' 블로트 확인: 실수로 대규모 .git 기록이나 로컬 로그를 압축하지 않았는지 확인합니다.

대용량 파일을 삭제한 후 프로젝트를 다시 마이그레이션해 보세요.

Antigravity 터미널에서 Firebase CLI 또는 `npx` 명령어가 실패하는 이유는 무엇인가요?

표준 시스템 터미널에서는 작동하지만 Antigravity 내에서 npx 명령어를 실행할 때 '명령어를 찾을 수 없음' 오류가 발생하거나 문제가 발생하는 경우 셸 환경이 초기화되는 방식 때문일 수 있습니다.

Antigravity의 터미널 환경은 ~/.bash_profile에서 구성 설정을 찾습니다. 하지만 많은 개발자가 npx 및 경로 구성을 ~/.bashrc에 저장합니다. 이러한 설정이 공유되지 않으면 Antigravity에서 도구를 찾을 수 없습니다.

.bash_profile 내에서 .bashrc 파일을 소싱하여 이 문제를 해결할 수 있습니다. 이렇게 하면 Antigravity가 시작될 때마다 기존 구성이 모두 로드됩니다.

Antigravity에서 ~/.bash_profile 파일을 엽니다.

아래 코드 블록을 파일에 추가합니다.

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

파일을 저장합니다.
Antigravity를 다시 시작합니다.

도움이 필요하신가요?

프로젝트 마이그레이션과 관련해 궁금한 점이나 의견이 있거나 문제가 발생한 경우 다음 중 한 곳에 문의하세요.

Firebase 지원팀에 문의
Firebase Studio 커뮤니티 포럼에 게시물 올리기