在 Google AI Studio 中构建 Android 应用

Google AI Studio 可让您通过自然语言提示构建原生 Android 应用。描述您想要的应用,Antigravity 智能体会生成一个完整的 Kotlin 和 Jetpack Compose 项目。您可以在浏览器中通过基于浏览器的 Android 模拟器预览应用,将其安装到实体设备上,以及发布应用以供测试。

Android 应用还支持 Firebase 集成,以便通过 Firebase AI Logic 和 App Check 调用 Gemini 模型、在 Cloud Firestore 中存储数据,以及使用 Firebase Authentication 让用户登录。

开始使用

如需开始构建 Android 应用,请执行以下操作:

  1. 使用左侧导航面板,前往 Google AI Studio 中的构建模式。
  2. 从平台选择器中选择 Android。
  3. 输入提示,描述您要构建的应用(例如,“创建一个具有本地存储功能的每日任务跟踪器”或“构建一个使用 AI 根据食材推荐餐点的食谱应用”)。
  4. 代理会生成项目,并在基于浏览器的 Android 模拟器中启动该项目。

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

Firebase 集成

Google AI Studio 与 Firebase 集成,因此您的 Android 应用可以安全地调用 Gemini 模型、持久保存数据并对用户进行身份验证,而无需自定义服务器端后端。当您提示智能体构建需要生成式 AI、数据库或登录功能时,它可以在您的 Firebase 项目中自动预配和配置以下服务:

  • Firebase AI Logic 和 Firebase App Check:直接从 Android 应用调用 Gemini 模型,而无需在 APK 中嵌入原始 API 密钥。AI Studio 会自动配置 App Check,以验证请求是否来自应用的真实实例:
    • 测试和共享(调试 build):在基于浏览器的模拟器中预览、通过 USB 安装或与测试人员共享时,使用由 AI Studio 自动管理的 App Check 调试令牌。
    • 发布到 Google Play(发布 build):在为 Google Play 构建发布版本时,自动切换到使用预配置网站密钥的 reCAPTCHA Enterprise。
  • Cloud Firestore:在 NoSQL 云数据库中存储和同步数据,包括自动生成的 Firestore 安全规则 (firestore.rules)。
  • Firebase Authentication:添加“使用 Google 账号登录”流程,以便对用户进行身份验证。

您可以在请求这些功能时,通过聊天中显示的设置卡片启用 Firebase,也可以随时在设置 > 集成下启用 Firebase。如需详细了解项目设置、共享配额和 App Check 生命周期,请参阅将 Firebase 添加到 Google AI Studio 应用。

基于浏览器的 Android 模拟器

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

模拟器提供:

  • Pixel 风格的设备模拟:点按、滚动应用并与之互动,就像在真实设备上一样。
  • 旋转支持:在纵向和横向之间切换。
  • 实时预览:当智能体更改代码时,应用会自动重新构建,模拟器也会自动刷新。

模拟器限制

基于浏览器的模拟器不支持所有硬件功能。模拟器中不提供以下功能:

  • 相机和照片拍摄
  • NFC 和蓝牙
  • GPS(位置信息为模拟信息)
  • Google Play 服务(Google 登录、Google 地图和其他 Play 服务功能可在真实设备上运行,但无法在模拟器中运行)

使用 ADB 在设备上安装

您可以将构建的 APK 直接安装到通过 USB 连接到计算机的实体 Android 设备上。此工具使用 WebUSB 通过浏览器与您的设备通信。无需在本地安装 ADB。

前提条件

  • 支持 WebUSB 的 Chrome 或 Edge 浏览器。
  • 一部已启用开发者选项和 USB 调试的 Android 设备。
  • 一根用于将设备连接到计算机的 USB 线。

在设备上安装应用

  1. 在预览面板中点击在设备上安装。
  2. 从浏览器的 USB 设备选择器中选择您的 Android 设备。
  3. APK 会传输并安装到您的设备上。
  4. 应用会自动启动。

发布到 Play 商店

您可以将 Android 应用发布到 Google Play 管理中心内部测试轨道,这样您就可以将应用分发给最多 100 位测试人员。

前提条件

  • Google Play 开发者账号(需要支付 25 美元的一次性注册费)。
  • 在 Play 管理中心内填写完整的开发者资料。

发布应用

  1. 在 Google AI Studio 中,依次打开设置 > 发布。
  2. 点击发布到 Play 商店。
  3. 使用您的 Google Play 开发者账号进行身份验证。
  4. AI Studio 会对 APK 进行签名、创建应用详情(或上传新版本),并发布到内部测试轨道。
  5. 您会收到一个可与测试人员分享的链接。

AI Studio 会使用托管式密钥库自动管理 APK 签名。您稍后可以在 Play 管理中心内自定义应用详情(图标、屏幕截图、说明)。

生成的内容

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

  • build 配置:使用 Kotlin DSL 的 build.gradle.kts 文件(项目级和应用级)。
  • 界面层:采用 Material 3 主题的 Jetpack Compose 组件。
  • 架构:具有 ViewModel 和数据类的单 activity 架构。
  • 资源:AndroidManifest.xml、可绘制对象、字符串和其他 Android 资源。
  • Firebase 配置(启用 Firebase 时):google-services.json、firebase_applet_config.xml 和 firestore.rules。

该智能体可自动管理 Gradle 依赖项,并根据需要从 Maven 和 Google 代码库中添加软件包。

您可以使用预览面板中的代码标签页查看和修改生成的代码。如需在 Android Studio 中继续开发,请以 ZIP 文件形式下载项目。

限制

在 AI Studio 中构建 Android 应用存在以下限制:

平台限制

  • 仅限客户端:Android 应用不包含服务器端组件。需要服务器运行时环境的功能(Secret Manager、多人游戏、Google Workspace API)不可用。
  • 单 activity 架构:仅支持单 activity、单模块项目。
  • 仅限 Jetpack Compose:应用使用 Kotlin 和 Jetpack Compose。不支持 Java 和 XML 布局。
  • 无 NDK 或原生代码:不支持 C 和 C++ 代码。
  • 不支持 Wear OS 或 Android TV:仅支持手机和平板电脑设备规格。

导出限制

  • 仅限 ZIP 下载:您可以将项目下载为 ZIP 文件。GitHub 导出功能尚不适用于 Android 项目。

后续步骤