# 在 Google AI Studio 中构建 Android 应用

Google AI Studio 可让您根据自然语言提示构建本机 Android 应用程序。描述您想要的应用程序，以及 [Antigravity 智能体](/docs/aistudio-build-mode#antigravity-agent)
生成完整的 Kotlin 和 [Jetpack 组合](https://developer.android.com/develop/ui/compose)
项目。您可以通过浏览器在基于浏览器的 Android 模拟器中预览应用程序，将其安装在物理设备上，然后发布以进行测试。

Android 应用程序也支持 [Firebase 集成](/docs/aistudio-android#firebase-integration) 用于使用 Firebase AI Logic 和 App Check 调用 Gemini 模型、在 Cloud Firestore 中存储数据以及使用 Firebase 身份验证登录用户。

{% callout type="note" %}
注意：AI Studio 中的 Android 应用程序仅是客户端。需要服务器端运行时的功能，例如 [Google Workspace API](/docs/aistudio-fullstack#workspace), [秘密管理](/docs/aistudio-fullstack#secrets), 和 [多人游戏](/docs/aistudio-fullstack#multiplayer)，仅适用于网络应用程序。
{% /callout %}

## 快速入门  {% #get-started %}

要开始构建 Android 应用程序：

1. 前往 [构建模式](https://aistudio.google.com/apps) 在 Google AI Studio 中使用左侧导航面板。
1. 选择 **安卓** 从平台选择器。
1. 输入描述您要构建的应用程序的提示（例如， *“使用本地存储创建每日任务跟踪器”* 或 *“构建一个食谱应用程序，使用人工智能根据食材建议膳食”*).
1. 智能体生成项目并在基于浏览器的 Android 模拟器中启动它。

然后，您可以使用聊天面板迭代您的应用程序，就像 Web 体验一样。 智能体管理 Android 项目中的所有文件并在代码库中传播更改。

## Firebase 集成  {% #firebase-integration %}

Google AI Studio 集成 [Firebase](https://firebase.google.com/docs/ai-assistance/ai-studio-integration)
因此您的 Android 应用程序可以安全地调用 Gemini 模型、保留数据并对用户进行身份验证，而无需自定义服务器端后端。当您提示智能体构建需要生成式 AI、数据库或登录的功能时，它可以在您的 Firebase 项目中自动预配和配置以下服务：

- **[Firebase人工智能逻辑](https://firebase.google.com/docs/ai-logic) 和 [Firebase 应用程序检查](https://firebase.google.com/docs/ai-logic/app-check)**：直接从 Android 应用程序调用 Gemini 模型，无需在 APK 中嵌入原始 API 密钥。 AI Studio 自动配置 App Check 以验证请求是否来自应用程序的真实实例：

- **测试和共享（调试版本）**：在基于浏览器的模拟器中预览、通过 USB 安装或与测试人员共享时，使用由 AI Studio 自动管理的 App Check 调试 token。

- **发布到 Google Play（发布版本）**：在构建 Google Play 发布版本时，使用预配置的站点密钥自动切换到 reCAPTCHA Enterprise。

- **云Firestore**：在 NoSQL 云数据库中存储和同步数据，包括自动生成的 Firestore 安全规则（`firestore.rules`).

- **Firebase认证**：添加“使用 Google 登录”流程来验证用户身份。

当您请求这些功能时，您可以从聊天中显示的设置卡启用 Firebase，或者随时在 **设置 > 集成**。有关项目设置、共享配额和 App Check 生命周期的详细信息，请参阅 [将 Firebase 添加到您的 Google AI Studio 应用程序](https://firebase.google.com/docs/ai-assistance/ai-studio-integration).

## 基于浏览器的 Android 模拟器  {% #emulator %}

Android 模拟器完全在云端运行并传输到您的浏览器。您无需安装 Android SDK、Android Studio 或本地模拟器。

模拟器提供：

- **类像素设备模拟**：点击、滚动并与您的应用程序交互，就像在真实设备上一样。

- **旋转支撑**：在纵向和横向之间切换。

- **实时预览**：当智能体进行代码更改时，应用程序会重建并且模拟器会自动刷新。

### 模拟器的限制  {% #emulator-limitations %}

基于浏览器的模拟器不支持所有硬件功能。以下内容在模拟器中不可用：

- 相机和照片捕捉
- NFC 和蓝牙
- GPS（模拟位置）
- Google Play 服务（Google 登录、地图和其他 Play 服务功能适用于真实设备，但不适用于模拟器）

## 使用 ADB 在设备上安装  {% #adb %}

您可以将构建的 APK 直接安装在使用 USB 连接到计算机的物理 Android 设备上。这使用 [网络USB](https://developer.chrome.com/docs/capabilities/usb) 通过浏览器与您的设备进行通信。无需本地 ADB 安装。

### 前提条件  {% #prerequisites %}

- 支持 WebUSB 的 Chrome 或 Edge 浏览器。

- 一台 Android 设备 [开发者选项和USB调试](https://developer.android.com/studio/debug/dev-options)
  已启用。

- 将您的设备连接到计算机的 USB 电缆。

### 在您的设备上安装该应用程序  {% #install-the-app-on-your-device %}

1. 点击 **在设备上安装** 在预览面板中。
1. 从浏览器的 USB 设备选择器中选择您的 Android 设备。
1. APK 已传输并安装在您的设备上。
1. 该应用程序会自动启动。

{% callout type="note" %}
注意：您的设备可能会显示 **“允许USB调试”** 第一次连接时会提示。您必须接受这一点才能继续。
{% /callout %}

## 发布到 Play 商店  {% #publish %}

您可以将您的 Android 应用程序发布到 [谷歌游戏控制台](https://play.google.com/console) 内部测试轨道，允许您将应用程序分发给最多 100 测试人员。

### 前提条件  {% #prerequisites %}

- A [Google Play 开发者帐户](https://play.google.com/console/signup)
  （需要一次性$25注册费）。

- Play 管理中心中完整的开发者资料。

### 发布您的应用程序  {% #publish-your-app %}

1. 打开 **设置 > 发布** 在 Google AI Studio 中。

1. 点击 **发布到 Play 商店**.

1. 使用您的 Google Play 开发者帐户进行身份验证。

1. AI Studio 对 APK 进行签名，创建应用程序列表（或上传新版本），然后发布到内部测试轨道。

1. 您会收到一个与测试人员分享的链接。

AI Studio 使用托管密钥库自动管理 APK 签名。您可以稍后在 Play 管理中心自定义应用列表（图标、屏幕截图、说明）。

{% callout type="note" %}
注：发布仅限于 **内部测试轨道** 仅。生产版本必须直接在 Google Play Console 中管理。
{% /callout %}

## 生成了什么  {% #whats-generated %}

当您构建 Android 应用程序时，智能体会生成一个基于 Gradle 的标准项目，其结构如下：

- **构建配置**: `build.gradle.kts` 使用 Kotlin DSL 的文件（项目和应用程序级别）。

- **用户界面层**: [Jetpack 组合](https://developer.android.com/develop/ui/compose)
  组件与 [材质 3](https://m3.material.io/) 主题化。

- **建筑**：具有 ViewModel 和数据类的单活动架构。

- **资源**: `AndroidManifest.xml`、可绘制对象、字符串和其他 Android 资源。

- **Firebase配置** （当Firebase启用时）： `google-services.json`, `firebase_applet_config.xml`, 和 `firestore.rules`.

智能体自动管理 Gradle 依赖项，根据需要添加来自 Maven 和 Google 存储库的包。

您可以使用以下命令查看和编辑生成的代码 **代码** 预览面板中的选项卡。要继续在 Android Studio 中进行开发，请将该项目下载为 **压缩文件**.

## 限制  {% #limitations %}

在 AI Studio 中构建 Android 应用程序具有以下限制：

### 平台限制  {% #platform-limitations %}

- **仅限客户端**：Android 应用程序不包含服务器端组件。需要服务器运行时的功能（秘密管理、多人游戏、Google Workspace API）不可用。

- **单活动架构**：仅支持单活动、单模块项目。

- **仅 Jetpack Compose**：应用程序使用 Kotlin 和 Jetpack Compose。不支持 Java 和 XML 布局。

- **没有 NDK 或本机代码**：不支持 C 和 C++ 代码。

- **无 Wear OS 或 Android TV**：仅支持手机和平板电脑外形规格。

### 出口限制  {% #export-limitations %}

- **仅 ZIP 下载**：您可以将项目下载为 ZIP 文件。 GitHub 导出尚不适用于 Android 项目。

## 后续步骤  {% #whats-next %}

- [在 Google AI Studio 中构建应用](/docs/aistudio-build-mode)
- [开发全栈应用程序](/docs/aistudio-fullstack) （网络）
- 请参阅中的示例 [应用程序库](https://aistudio.google.com/apps?source=showcase).
