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 모드에서 시작했지만 클라우드 제한 없이 로컬 환경이 필요한 중요한 기능 또는 실행 스크립트를 추가한 경우

Google AI Studio로 마이그레이션

AI의 기능을 브라우저에 제공하는 웹 기반 프로토타입 제작 환경을 위해서는 migrating to Google AI Studio하는 것이 좋습니다. 프롬프트에서 풀스택 프로덕션 앱으로의 가장 빠른 경로를 제공합니다. 다음 기준 중 하나를 충족하는 경우 Google AI Studio를 선택해야 합니다.

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

앱을 Google AI Studio로 마이그레이션

Google AI Studio는 프롬프트에서 풀스택 프로덕션 앱으로의 가장 빠른 경로를 제공합니다.

1단계: 작업공간 전송

1. 작업공간 상단의 지금 이동 버튼을 클릭한 다음 AI Studio 준비 를 선택합니다.
2. 준비 단계가 완료되면 Google AI Studio로 이동Google AI Studio 을 클릭합니다.
3. 요청이 있으면 서비스 약관을 검토하고 이에 동의합니다. 코드가 새 Google AI Studio 작업공간에서 자동으로 열립니다.

Google AI Studio에서 앱을 변환하고 로드하는 데 몇 분 정도 걸릴 수 있습니다. 완료되면 알림이 전송됩니다. 완료되면 에이전트의 도움을 받아 앱을 계속 반복할 수 있습니다.Google AI Studio Google AI Studio에서 앱 빌드에 대해 자세히 알아보세요.

2단계: 게시 방법 선택

배포 요구사항과 기존 애플리케이션 URL을 유지할지 여부에 따라 다음 게시 방법 중 하나를 선택합니다.

옵션 A: App Hosting에 게시하고 기존 URL 유지

이전에 Firebase Studio을(를) 통해 앱을 게시했고 *.hosted.app URL 또는 커스텀 도메인을 유지하려면 Gemini API 키를 보호하고 GitHub 동기화를 사용하세요.

1. Gemini API 키를 보호합니다.

   1. Firebase 콘솔에서 App Hosting 페이지로 이동합니다.
   2. 기존 백엔드 (일반적으로 studio라는 이름)를 찾아 보기 를 클릭합니다.
   3. 설정 탭에서 환경 으로 이동합니다.

   4. 새로 추가 를 클릭하고 .env 파일의 콘텐츠를 키 필드에 붙여넣어 Gemini API 키를 환경 변수로 안전하게 저장합니다.

2. Google AI Studio에서 GitHub에 동기화합니다.

   1. Google AI Studio에서 설정 아이콘을 클릭하고 GitHub 패널로 이동합니다.
   2. GitHub에 로그인 을 클릭하고 Google AI Studio GitHub 앱을 설치합니다.

   3. GitHub 저장소 만들기 를 클릭합니다.

   4. 모든 변경사항 스테이징 및 커밋 을 선택합니다.

3. 저장소를 App Hosting에 연결합니다.

   1. Firebase 콘솔에서 App Hosting 페이지로 이동합니다.
   2. 기존 백엔드 (일반적으로 studio라는 이름)를 찾아 보기 를 클릭합니다.
   3. 설정 탭에서 배포 > GitHub에 연결 을 선택합니다.
   4. GitHub에 로그인하고 Firebase App Hosting GitHub 앱을 설치합니다.
   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는 AI의 기능을 로컬 개발 환경에 제공하는 로컬 에이전트 중심 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. firebase deploy를 실행하라는 메시지가 표시되면 예를 선택합니다. 이전에 Firebase App Hosting에 게시한 적이 있는 경우 에이전트가 기존 URL에 게시합니다. App Hosting에 처음 게시하는 경우 에이전트가 절차를 안내해 드립니다.

3. 향후 업데이트를 위해 에이전트에게 Antigravity 채팅 패널에서 publish my app하라고 안내합니다.

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

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

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

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

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

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 디렉터리에서 작업공간의 Firebase 에이전트에서 App Prototyping agent 및 Gemini의 Gemini 채팅 기록 파일을 찾을 수 있습니다. Firebase Studio 여기에는 모든 Gemini 채팅 모드의 프롬프트와 대답이 포함됩니다.

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

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

Prototyper 세션의 경우 프롬프트를 git 로그의 일부로 볼 수도 있습니다. 찾는 방법은 다음과 같습니다.

1. 코드 뷰()를 엽니다.

2. 다음 중 하나를 수행합니다.

   • 터미널 세션(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 명령을 실행합니다.

Google AI Studio로 마이그레이션한 앱은 어디에서 찾을 수 있나요?

내 앱 페이지에는 Google AI Studio에서 처음부터 만든 프로젝트와 마이그레이션한 프로젝트를 비롯한 모든 프로젝트의 통합 목록이 제공됩니다. Google AI Studio

Firebase Authentication을 통한 Google 로그인이 Google AI Studio로 마이그레이션한 후 작동하지 않습니다.

앱에서 Google 로그인을 사용하는 경우 새 프로젝트 도메인을 승인해야 합니다.

1. Firebase 콘솔에서 Authentication 설정 페이지로 이동합니다.
2. 승인된 도메인 을 클릭합니다.
3. 도메인 추가 를 클릭하고 Google AI Studio 앱의 도메인을 추가합니다.

마이그레이션 후 Google AI Studio 에이전트가 작동을 중지하거나 Google AI Studio에 오류가 표시되면 어떻게 해야 하나요?

Google AI Studio 에이전트는 앱을 마이그레이션하는 동안 복잡한 백그라운드 작업을 관리하므로 에이전트에서 "작업 취소됨", 반복 메시지 또는 응답하지 않는 스레드와 같은 문제가 가끔 발생할 수 있습니다.

• 에이전트가 명확한 오류 없이 작업 중간에 중지되면 '중단한 부분부터 계속' 또는 '마지막 단계를 다시 시도'와 같은 프롬프트를 제공하면 프로세스가 시작되는 경우가 많습니다.
• 코드를 실행하는 중에 오류가 발생했다는 메시지가 표시되면 수정 버튼을 클릭하여 에이전트가 자동으로 해결하도록 프롬프트를 입력합니다.

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

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

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

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

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

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

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

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

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

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

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

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

3. 파일을 저장합니다.

4. Antigravity를 다시 시작합니다.

기타 리소스

• Antigravity로 마이그레이션 Codelab을 사용해 보세요.Firebase Studio
• Antigravity 문서를 살펴보세요.
• Google AI Studio 문서를 살펴보세요.

도움이 필요하신가요?

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

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