Google AI Studio에서 Android 앱 빌드

Google AI Studio를 사용하면 자연어 프롬프트에서 네이티브 Android 앱을 빌드할 수 있습니다. 원하는 앱을 설명하면 Antigravity 에이전트가 완전한 Kotlin 및 Jetpack Compose 프로젝트를 생성합니다. 브라우저에서 브라우저 기반 Android 에뮬레이터로 앱을 미리 보고, 실제 기기에 설치하고, 테스트용으로 게시할 수 있습니다.

Android 앱은 Firebase AI Logic 및 앱 체크를 사용하여 Gemini 모델을 호출하고, Cloud Firestore에 데이터를 저장하고, Firebase 인증으로 사용자를 로그인 처리하는 Firebase 통합도 지원합니다.

시작하기

Android 앱 빌드를 시작하려면 다음 단계를 따르세요.

왼쪽 탐색 패널을 사용하여 Google AI Studio의 빌드 모드로 이동합니다.
플랫폼 선택 도구에서 Android를 선택합니다.
빌드하려는 앱을 설명하는 프롬프트를 입력합니다 (예: '로컬 스토리지를 사용하는 일일 작업 추적기를 만들어 줘' 또는 'AI를 사용하여 재료로 식사를 추천하는 레시피 앱을 빌드해 줘').
에이전트가 프로젝트를 생성하고 브라우저 기반 Android Emulator에서 실행합니다.

그런 다음 웹 환경과 마찬가지로 채팅 패널을 사용하여 앱을 반복할 수 있습니다. 에이전트는 Android 프로젝트의 모든 파일을 관리하고 코드베이스 전체에 변경사항을 전파합니다.

Firebase 통합

Google AI Studio는 Firebase와 통합되므로 Android 앱에서 커스텀 서버 측 백엔드 없이 Gemini 모델을 안전하게 호출하고, 데이터를 유지하고, 사용자를 인증할 수 있습니다. 생성형 AI, 데이터베이스 또는 로그인이 필요한 기능을 빌드하라는 프롬프트를 에이전트에 작성하면 에이전트가 Firebase 프로젝트에서 다음 서비스를 자동으로 프로비저닝하고 구성할 수 있습니다.

Firebase AI Logic 및 Firebase 앱 체크: APK에 원시 API 키를 삽입하지 않고도 Android 앱에서 직접 Gemini 모델을 호출합니다. AI Studio는 앱 체크를 자동으로 구성하여 요청이 앱의 인증된 인스턴스에서 시작되었는지 확인합니다.
- 테스트 및 공유 (디버그 빌드): 브라우저 기반 에뮬레이터에서 미리 보거나, USB를 통해 설치하거나, 테스터와 공유할 때 AI Studio에서 자동으로 관리하는 앱 체크 디버그 토큰을 사용합니다.
- Google Play에 게시 (출시 빌드): Google Play의 출시 버전을 빌드할 때 사전 구성된 사이트 키를 사용하여 reCAPTCHA Enterprise로 자동 전환합니다.
Cloud Firestore: 자동으로 생성된 Firestore 보안 규칙(firestore.rules)을 포함하여 NoSQL 클라우드 데이터베이스에 데이터를 저장하고 동기화합니다.
Firebase 인증: 'Google 계정으로 로그인' 흐름을 추가하여 사용자를 인증합니다.

이러한 기능을 요청할 때 채팅에 표시되는 설정 카드에서 또는 언제든지 설정 > 통합에서 Firebase를 사용 설정할 수 있습니다. 프로젝트 설정, 공유 할당량, 앱 체크 수명 주기에 관한 자세한 내용은 Google AI Studio 앱에 Firebase 추가를 참고하세요.

브라우저 기반 Android Emulator

Android Emulator는 전적으로 클라우드에서 실행되며 브라우저로 스트리밍됩니다. Android SDK, Android 스튜디오 또는 로컬 에뮬레이터를 설치할 필요가 없습니다.

에뮬레이터는 다음을 제공합니다.

Pixel과 유사한 기기 시뮬레이션: 실제 기기에서와 마찬가지로 앱을 탭하고 스크롤하고 상호작용합니다.
회전 지원: 세로 모드와 가로 모드 간에 전환합니다.
실시간 미리보기: 에이전트가 코드를 변경하면 앱이 다시 빌드되고 에뮬레이터가 자동으로 새로고침됩니다.

에뮬레이터 제한사항

브라우저 기반 에뮬레이터는 일부 하드웨어 기능을 지원하지 않습니다. 다음은 에뮬레이터에서 사용할 수 없습니다.

카메라 및 사진 캡처
NFC 및 블루투스
GPS (위치 시뮬레이션)
Google Play 서비스 (Google 로그인, 지도, 기타 Play 서비스 기능은 실제 기기에서 작동하지만 에뮬레이터에서는 작동하지 않음)

ADB를 사용하여 기기에 설치

USB를 사용하여 컴퓨터에 연결된 실제 Android 기기에 빌드된 APK를 직접 설치할 수 있습니다. 이렇게 하면 WebUSB를 사용하여 브라우저를 통해 기기와 통신합니다. 로컬 ADB 설치가 필요하지 않습니다.

기본 요건

WebUSB를 지원하는 Chrome 또는 Edge 브라우저
개발자 옵션 및 USB 디버깅이 사용 설정된 Android 기기
기기를 컴퓨터에 연결하는 USB 케이블

기기에 앱 설치

미리보기 패널에서 기기에 설치를 클릭합니다.
브라우저의 USB 기기 선택 도구에서 Android 기기를 선택합니다.
APK가 기기로 전송되고 설치됩니다.
앱이 자동으로 실행됩니다.

Play 스토어에 게시

Android 앱을 Google Play Console 내부 테스트 트랙에 게시하여 최대 100명의 테스터에게 앱을 배포할 수 있습니다.

기본 요건

Google Play 개발자 계정(일회성 등록 수수료 25달러 필요)
Play Console에서 개발자 프로필을 작성해야 합니다.

앱 게시

Google AI Studio에서 설정 > 게시를 엽니다.
Play 스토어에 게시를 클릭합니다.
Google Play 개발자 계정으로 인증합니다.
AI Studio는 APK에 서명하고, 앱 등록정보를 만들거나 새 버전을 업로드하고, 내부 테스트 트랙에 게시합니다.
테스터와 공유할 수 있는 링크를 받습니다.

AI Studio는 관리형 키 저장소를 사용하여 APK 서명을 자동으로 관리합니다. 나중에 Play Console에서 앱 등록정보 (아이콘, 스크린샷, 설명)를 맞춤설정할 수 있습니다.

생성되는 항목

Android 앱을 빌드할 때 에이전트는 다음 구조의 표준 Gradle 기반 프로젝트를 생성합니다.

빌드 구성: Kotlin DSL을 사용하는 build.gradle.kts 파일 (프로젝트 및 앱 수준)
UI 레이어: Material 3 테마 설정이 적용된 Jetpack Compose 구성요소
아키텍처: ViewModel 및 데이터 클래스가 있는 단일 활동 아키텍처
리소스: AndroidManifest.xml, 드로어블, 문자열, 기타 Android 리소스
Firebase 구성 (Firebase가 사용 설정된 경우): google-services.json, firebase_applet_config.xml, firestore.rules

에이전트는 Gradle 종속 항목을 자동으로 관리하여 필요에 따라 Maven 및 Google 저장소에서 패키지를 추가합니다.

미리보기 패널의 코드 탭을 사용하여 생성된 코드를 보고 수정할 수 있습니다. Android 스튜디오에서 개발을 계속하려면 프로젝트를 ZIP 파일로 다운로드합니다.

제한사항

AI Studio에서 Android 앱을 빌드하는 경우 다음과 같은 제한사항이 있습니다.

플랫폼 제한사항

클라이언트 측 전용: Android 앱에는 서버 측 구성요소가 포함되지 않습니다. 서버 런타임이 필요한 기능 (Secret Manager, 멀티플레이어, Google Workspace API)은 사용할 수 없습니다.
단일 활동 아키텍처: 단일 활동, 단일 모듈 프로젝트만 지원됩니다.
Jetpack Compose만 사용: 앱에서 Kotlin과 Jetpack Compose를 사용합니다. Java 및 XML 레이아웃은 지원되지 않습니다.
NDK 또는 네이티브 코드 없음: C 및 C++ 코드는 지원되지 않습니다.
Wear OS 또는 Android TV 없음: 휴대전화 및 태블릿 폼 팩터만 지원됩니다.

내보내기 제한

ZIP 다운로드 전용: 프로젝트를 ZIP 파일로 다운로드할 수 있습니다. Android 프로젝트에서는 아직 GitHub 내보내기를 사용할 수 없습니다.