Google AI Studio에서 앱 빌드하기
Google AI Studio에서 앱 빌드하기
Google AI Studio를 사용해 Gemini의 최신 기능을 시험해 보는 앱을 빠르게 빌드("바이브 코딩")하고 배포하는 방법을 설명해요. 풀스택 웹 앱과 네이티브 Android 앱을 자연어 프롬프팅만으로 만들 수 있어요.
출처: 원문
본문
이 페이지는 Nano Banana와 Live API 같은 Gemini의 최신 기능을 시험해 보는 앱을 Google AI Studio로 빠르게 빌드("바이브 코딩")하고 배포하는 방법을 설명해요. Google AI Studio는 풀스택 런타임의 웹 앱과 Kotlin·Jetpack Compose의 네이티브 Android 앱 빌드를 지원하며, 모두 자연어 프롬프팅으로 가능해요.
시작하기
Google AI Studio의 Build 모드에서 바이브 코딩을 시작하세요. 여러 가지 방법으로 빌드를 시작할 수 있어요:
- 프롬프트로 시작: Build 모드에서 입력 칸에 만들고 싶은 것을 설명하세요. AI Chips를 선택해 이미지 생성이나 Google Maps 데이터 같은 특정 기능을 프롬프트에 추가할 수 있어요. 음성-텍스트 버튼으로 말로 표현할 수도 있어요.
- "I'm Feeling Lucky" 버튼: 창의적 영감이 필요하다면 이 버튼을 사용하세요. Gemini가 프로젝트 아이디어가 담긴 프롬프트를 생성해 시작을 도와줘요.
- 갤러리에서 프로젝트 리믹스: 앱 갤러리에서 프로젝트를 열고 Copy App을 선택하세요.
- GitHub에서 프로젝트 가져오기: Build 모드에서 프롬프트 입력 칸의 Add files(+ 아이콘) 메뉴에서 Import from GitHub를 선택해 기존 코드를 가져오세요.
프롬프트를 실행하면 필요한 코드와 파일이 생성되고, 오른쪽에 앱의 라이브 프리뷰가 나타나요.
무엇이 만들어지나요?
프롬프트를 실행하면 AI Studio가 완전한 애플리케이션을 만들어요. 플랫폼 선택기로 웹 앱이나 네이티브 Android 앱을 고를 수 있어요.
웹 앱(기본)의 경우 AI Studio는 다음을 포함한 풀스택 환경을 만들어요:
- 클라이언트 측: 웹 프론트엔드 (기본은 React).
- 서버 측: 보안 API 호출, 데이터베이스 연결, npm 패키지 사용이 가능한 Node.js 런타임.
Android 앱의 경우 AI Studio는 브라우저 기반 에뮬레이터에서 미리 볼 수 있고, 물리적 기기에 설치할 수 있으며, 테스트를 위해 Play Store에 게시할 수 있는 Kotlin·Jetpack Compose 프로젝트를 생성해요. Android 앱 빌드에 대해 더 알아보기.
오른쪽 프리뷰 창에서 Code 탭을 선택하면 생성된 코드를 볼 수 있어요. Antigravity Agent가 스택 전반의 여러 파일을 지능적으로 관리해 변경 사항이 올바르게 전파되도록 해요.
Antigravity Agent
Antigravity Agent는 Google Antigravity의 주요 AI 기능이며, 이제 그 에이전트 하네스의 핵심 구성 요소가 Google AI Studio의 Build 모드 경험을 지원해요. 단순 코드 생성을 넘어 프로젝트 전체의 컨텍스트를 유지하고, 여러 파일을 관리하며, 복잡한 지침을 이해해 견고한 풀스택 애플리케이션을 만들어요.
주요 기능은 다음과 같아요:
- 컨텍스트 인식: 이전 프롬프트와 파일 상태의 컨텍스트를 유지.
- 다중 파일 관리: 여러 파일 간 의존성 처리.
- 검증된 실행: 환각을 줄이기 위해 코드 업데이트를 검증.
풀스택 기능
Google AI Studio는 현대 웹 생태계의 힘을 열어, 클라이언트 측 프로토타입 이상을 빌드할 수 있게 해줘요.
- 서버 측 런타임과 npm: 방대한 npm 패키지 라이브러리를 사용하세요. 에이전트가 앱에 필요한 패키지(예: 데이터 시각화용 특정 라이브러리, API 클라이언트)를 자동으로 식별·설치해요. 원하면 특정 패키지를 요청할 수도 있어요.
- 시크릿 관리: Settings 메뉴에서 API 키와 시크릿을 안전하게 저장하세요. 서버 측 코드에서 접근할 수 있어 클라이언트 측 노출로부터 안전해요.
- 멀티플레이어: AI Studio 안에서 직접 실시간 협업 경험을 빌드하세요. 서버 측 런타임이 사용자들이 함께 상호작용하는 데 필요한 상태와 연결을 관리해요.
- Firebase Firestore와 인증: Firebase를 자동 프로비저닝·설정해요. Firestore 데이터베이스(영구 데이터 저장)와 Firebase Authentication(로그인 흐름, 특히 "Google로 로그인")을 포함해요. 에이전트가 전체 설정 과정을 처리하고 심지어 앱 코드도 작성해요.
- Google Workspace 통합: Gmail, Sheets, Docs, Drive, Calendar 같은 Google Workspace API에 앱을 연결하세요. AI Studio가 모든 OAuth 구성을 자동으로 처리해요.
Android 앱
Kotlin과 Jetpack Compose로 네이티브 Android 앱을 빌드할 수도 있어요. 브라우저 기반 Android 에뮬레이터에서 앱을 미리 보고, 브라우저에서 ADB로 물리적 기기에 설치하며, 내부 테스트를 위해 Play Store에 게시할 수 있어요.
계속 빌드하기
Google AI Studio가 애플리케이션의 초기 코드를 생성하면 계속 다듬을 수 있어요:
Google AI Studio에서 빌드
- Gemini로 반복: Build 모드의 채팅 패널로 Gemini에게 수정, 새 기능 추가, 스타일 변경을 요청하세요.
- 코드 직접 편집: 프리뷰 패널의 Code 탭을 열어 라이브 편집하세요.
외부에서 개발
더 고급 워크플로를 위해 원하는 환경에서 작업하도록 코드를 동기화하거나 내보낼 수 있어요:
- GitHub와 동기화: 앱을 GitHub 저장소에 연결해 양방향 동기화를 활성화하세요. AI Studio에서 프롬프트한 변경 사항을 AI 생성 커밋 메시지로 저장소에 직접 푸시하거나, IDE나 팀원이 로컬에서 만든 변경 사항을 다시 AI Studio로 가져올 수 있어요. Settings의 GitHub 탭에서 동기화 상태를 관리하세요.
- 다운로드해서 로컬 개발: 생성된 코드를 ZIP 파일로 내보내 코드 편집기로 가져오세요.
주요 기능
Google AI Studio에는 빌드 과정을 직관적이고 시각적으로 만드는 몇 가지 기능이 있어요:
- 풀스택 앱 생성·반복: 프롬프트만으로 풀스택 앱을 만들고 채팅이나 주석 모드로 반복할 수 있어요. 주석 모드에서는 앱 UI의 어떤 부분이든 강조하고 원하는 변경을 설명할 수 있어요.
- 앱 공유·배포: 협업이나 쇼케이스를 위해 만든 것을 다른 사람과 공유할 수 있어요. 공유 시 API 호출이 사용 한도에 계산돼요. 유료 모델을 사용하면 비용이 발생할 수 있어요. 앱이 준비되면 Cloud Run에 배포하세요.
- 앱 갤러리: 앱 갤러리는 프로젝트 아이디어의 시각적 라이브러리를 제공해요. Gemini로 가능한 것을 둘러보고, 애플리케이션을 즉시 미리 보고, 리믹스해 나만의 것으로 만들 수 있어요.
앱 배포 또는 아카이브
애플리케이션이 준비되면 배포할 수 있어요:
- Cloud Run: 애플리케이션을 확장 가능한 서비스로 배포하세요. Google Cloud Run 가격은 사용량에 따라 적용될 수 있어요. 배포에 대해 더 알아보려면 Google AI Studio에서 배포하기를 참고하세요.
- GitHub: 새 GitHub 저장소나 기존 저장소와 프로젝트를 동기화해 소스 코드를 관리하거나 팀원과 협업하세요.
제한 사항
이 섹션은 Google AI Studio Build 모드의 현재 제한 사항을 나열해요.
API 키 관리
Gemini API를 사용하는 새 앱을 만들면 AI Studio가 자동으로 Gemini API 키를 앱의 서버 측 환경에 시크릿으로 구성해요. Secrets 패널에서 이 키를 보고 관리할 수 있어요.
- 자동 설정:
GEMINI_API_KEY가 자동 설정돼요 — 빌드를 시작하는 데 수동 구성이 필요 없어요. - 서버 측 전용: API 키는 서버 측 런타임에 주입되며 클라이언트 측 코드에는 절대 포함되지 않아요.
- 기존 앱: 2026년 5월 14일 이전에 빌드된 앱의 경우, 앱의 Gemini 기능을 다음에 수정할 때 에이전트가 권장 서버 측 접근 방식으로 Gemini API 통합을 자동 업그레이드해요.
Google AI Studio 외부 배포
- Cloud Run: AI Studio에서 Cloud Run으로 배포하면 API 키가 서버 측 환경에 안전하게 포함돼요. 배포된 앱은 모든 사용자의 Gemini API 호출에 여러분의 API 키를 사용해요.
- ZIP 다운로드: 앱을 ZIP 파일로 다운로드해 다른 곳에서 실행하려면 호스팅 환경에서
GEMINI_API_KEY환경 변수를 설정해야 해요. 앱의 Gemini API 호출은 서버 측 코드에서 이뤄지므로 키가 최종 사용자에게 노출되지 않아요.
앱 공유 시 오류
앱을 공유했는데 최종 사용자가 공유 URL 사용 시 403 Access Restricted 오류가 난다면, 다음 중 하나 때문일 수 있어요:
- 브라우저 확장 프로그램: Privacy Badger 같은 개인정보 보호 확장 프로그램이 앱을 차단하고 있을 수 있어요. 확장 프로그램을 비활성화해 오류를 피하세요.
- 빌드 문제: 현재 코드에 문제가 있을 수 있어요. 에이전트에게 "현재 코드의 빌드 문제를 고쳐줘"라고 프롬프트한 뒤 URL을 다시 공유하세요.
FAQ
AI Studio의 Build란 무엇인가요?
AI Studio Build는 Gemini를 사용해 간단한 프롬프트에서 프로덕션 준비가 된 AI 기반 애플리케이션으로 이어주는 플랫폼이에요. 만들고 싶은 것을 프롬프트로 설명하면 Gemini가 앱을 생성해요. 갤러리를 둘러보며 Gemini API로 가능한 것을 확인하고, 앱을 리믹스해 나만의 것으로 만들 수도 있어요.
Build는 내 Gemini API 키를 어떻게 처리하나요?
Gemini API를 사용하는 앱을 만들면 AI Studio가 자동으로 Gemini API 키를 서버 측 시크릿으로 설정해요. 앱의 Gemini API 호출은 이 키를 사용해 서버 측 코드에서 이뤄지므로 브라우저에 노출되지 않아요. Settings의 Secrets 패널에서 API 키를 볼 수 있어요.
앱을 공유하면 API 키가 노출되나요?
아니요. API 키는 서버 측 시크릿으로 저장되며 클라이언트 측 코드에 절대 포함되지 않아요. 앱을 공유하면 다른 사용자가 사용할 수 있지만 API 키는 볼 수 없어요.
다른 사람과 앱을 공유할 때 API 호출이 사용 한도에 계산돼요. 유료 모델을 사용하면 비용이 발생할 수 있어요. AI Studio는 설정 중과 공유 전에 앱이 비용을 발생시킬 수 있다면 알려줘요.
내 앱을 누가 볼 수 있나요?
기본적으로 앱은 비공개예요. 앱을 다른 사용자와 공유해 사용하게 할 수 있어요. 공유한 사용자는 앱의 코드를 보고 자신의 목적으로 포크할 수 있어요. 편집 권한으로 공유하면 다른 사용자가 앱 코드를 편집할 수 있어요.
AI Studio 밖에서 앱을 실행할 수 있나요?
네. AI Studio에서 Cloud Run으로 앱을 배포할 수 있어요. 그러면 서버 측 환경에 API 키가 안전하게 구성된 공개 URL이 제공돼요. 앱을 ZIP 파일로 다운로드해 다른 곳에 호스팅할 수도 있는데, 호스팅 환경에서 GEMINI_API_KEY 환경 변수를 설정해야 해요. Gemini API 호출은 서버 측 코드에서 이뤄지므로 키가 안전하게 유지돼요.
배포 옵션에 대해 더 알아보려면 Google AI Studio에서 배포하기를 참고하세요.
내 도구로 로컬에서 앱을 개발한 뒤 여기서 공유할 수 있나요?
네. AI Studio 앱을 GitHub 저장소에 연결해 선호하는 코드 편집기나 CLI 도구로 로컬에서 개발하고, 변경 사항을 GitHub에 푸시한 뒤 Settings의 GitHub 탭을 사용해 그 업데이트를 다시 AI Studio로 가져올 수 있어요.
앱에 데이터베이스나 다른 저장소를 어떻게 사용하나요?
AI Studio 앱은 Cloud Run 컨테이너에서 실행되는 표준 앱이에요. 동적 IP 범위에서 접근을 막는 방화벽이 없다면, 네트워크로 연결할 수 있는 어떤 저장소 솔루션이든 사용할 수 있어요.
향후 AI Studio 안에서 직접 구성할 수 있는 저장소 직접 지원을 추가하는 작업을 하고 있어요.
마이크, 웹캠, 기타 Navigator API에 어떻게 접근하나요?
뷰어가 앱의 웹캠이나 다른 기기 사용을 인지하도록, 앱이 이러한 Navigator API에 접근하기 전에 추가 확인을 요구해요. 앱 제작자는 앱의 metadata.json 파일에 권한 요청을 추가할 수 있어요. 예:
{
"name": "My app",
"requestFramePermissions": [
"microphone",
"camera",
"display-capture",
"geolocation",
"bluetooth",
"clipboard-read",
"serial",
"usb"
]
}
requestFramePermissions의 지원 값은 표준 policy-controlled features의 부분 집합이에요.
앱에서 GitHub를 어떻게 사용하나요?
AI Studio는 GitHub와 양방향 동기화를 지원해요:
- 저장소 가져오기: Build 모드에서 프롬프트 입력 칸의 Add files(+ 아이콘) 메뉴에서 Import from GitHub를 선택해 기존 코드를 가져오세요.
- 저장소 연결: Settings에서 GitHub 탭을 열어 앱에서 새 GitHub 저장소를 만들거나 기존 저장소에 연결하세요.
- 양방향 동기화: AI Studio에서 프롬프트한 변경 사항을 AI 생성 커밋 메시지로 저장소에 직접 푸시하거나, 외부에서 만든 변경 사항(로컬 IDE 편집, 팀원 풀 리퀘스트 등)을 다시 AI Studio로 가져오세요.
- 병합 충돌 해결: GitHub와 동기화할 때 충돌하면 AI Studio가 나란히 diff 뷰어가 있는 Resolve conflicts 대화상자를 제공해, 각 충돌 파일에 대해 AI Studio 버전을 유지할지 GitHub 버전을 유지할지 검토·선택할 수 있어요.
다른 사용자에게 앱 편집 권한을 줄 수 있나요?
AI Studio는 직접 실시간 협업 편집을 지원하지 않아요. 하지만 앱을 공유 GitHub 저장소에 연결하면 팀원과 협업할 수 있어요. 팀원이 GitHub에서 변경 사항을 푸시하거나 풀 리퀘스트를 열 수 있고, 그 업데이트를 AI Studio로 가져올 수 있어요.
앱이 정책 위반으로 플래그된 이유는 무엇인가요?
우리는 앱을 자동 검토해 정책을 준수하는지 확인하는 시스템을 운영해요. 앱이 정책을 위반하면 AI Studio에서 제거돼요. 정책 위반에는 다음이 포함되지만 이에 국한되지 않아요:
- 맬웨어, 피싱, 사칭을 포함한 앱
- 아동 성적 학대 이미지 정책을 위반하는 콘텐츠를 표시·배포하는 앱
- 괴롭힘 정책을 위반하는 콘텐츠를 표시·배포하는 앱
- 증오 발언 정책을 위반하는 콘텐츠를 표시·배포하는 앱
- 인신매매 정책을 위반하는 콘텐츠를 표시·배포하는 앱
- 성적으로 노골적인 콘텐츠 정책을 위반하는 콘텐츠를 표시·배포하는 앱
- 폭력과 잔혹 행위 정책을 위반하는 콘텐츠를 표시·배포하는 앱
- 유해하거나 위험한 콘텐츠 정책을 위반하는 콘텐츠를 표시·배포하는 앱
앱이 정책 위반으로 플래그됐는데 오류라고 생각하면 이의를 제기할 수 있어요. 정책을 반복 위반하면 AI Studio 접근이 종료될 수 있어요.
앱 개발자로서 내 책임은 무엇인가요?
앱의 소유자로서 애플리케이션의 동작과 처리하는 모든 데이터에 책임이 있음을 상기하세요. 여기에는 다음이 포함돼요:
- 법적 준수와 제3자 권리: 앱이 모든 관련 법률·규정을 준수하고 지적 재산권, 개인정보 보호권을 포함한 타인의 권리를 침해하지 않는지 확인.
- 콘텐츠 모니터링: 앱이 사용하는 다른 서비스에 추가 약관이 적용될 수 있어요. 예를 들어 Firestore에 적용되는 Google Cloud 이용약관은 제3자 콘텐츠를 호스팅하는 고객이 어떤 콘텐츠가 금지되는지(예: 불법 콘텐츠) 정의하는 정책을 게시하고 그 불법 콘텐츠 존재를 모니터링하도록 요구해요.
- 안전한 구현: 애플리케이션이 오용되지 않도록 필요한 보호 장치와 모더레이션 도구 구현.
이용약관의 사용 제한을 유의하세요.
AI Studio 앱 갤러리의 앱에는 어떤 약관이 적용되나요?
별도로 명시되지 않는 한, AI Studio 앱 갤러리에 소개된 앱 사용에는 Gemini API 추가 이용약관이 적용돼요.
다음으로
- 풀스택 앱 개발 (웹)
- Android 앱 빌드
- 앱 갤러리에서 예시 보기.