在 Google AI Studio 中构建应用

本页面介绍了如何使用 Google AI Studio 快速构建（或“氛围编码”）和部署应用，以测试 Gemini 的最新功能，例如 Nano Banana 和 Live API。Google AI Studio 支持使用全栈运行时构建 Web 应用，以及使用 Kotlin 和 Jetpack Compose 构建原生 Android 应用，所有这些都通过自然语言提示完成。

开始使用

在 Google AI Studio 的构建模式中开始氛围编程。您可以通过以下几种方式开始构建：

  • 从提示开始：在构建模式下，使用输入框输入您要构建的内容的说明。选择 AI 提示，在提示中添加特定功能，例如图片生成或 Google 地图数据。您甚至可以使用语音转文字按钮说出您想要的内容。
  • “手气不错”按钮：如果您需要创意灵感，可以使用“手气不错”按钮，Gemini 会生成一个包含项目创意的提示，帮助您快速上手。
  • 从图库中改编项目：从应用图库中打开一个项目，然后选择复制应用。
  • 从 GitHub 导入项目：在“构建”模式下，从提示输入框中的添加文件（“+”图标）菜单中选择从 GitHub 导入，即可导入现有代码。

运行提示后，您会看到系统生成了必要的代码和文件，右侧会实时显示应用的预览效果。

创建了什么？

运行提示后，AI Studio 会创建一个完整的应用。您可以使用平台选择器选择构建 Web 应用或原生 Android 应用。

对于 Web 应用（默认），AI Studio 会创建一个全栈环境，其中包括：

  • 客户端：Web 前端（默认为 React）。
  • 服务器端：一个 Node.js 运行时，支持安全的 API 调用、数据库连接和 npm 软件包使用。

对于 Android 应用，AI Studio 会生成一个 Kotlin 和 Jetpack Compose 项目，您可以在基于浏览器的模拟器中预览该项目，也可以将其安装在实体设备上，并发布到 Play 商店进行测试。详细了解如何构建 Android 应用。

您可以在右侧预览窗格中选择代码标签页，查看生成的代码。Antigravity 智能体可智能管理整个堆栈中的多个文件，确保更改正确传播。

Antigravity 智能体

Antigravity 智能体是 Google Antigravity 中的主要 AI 功能，现在，智能体框架的核心组件正在为 Google AI Studio 中的构建模式体验提供支持。它不仅能生成简单的代码，还能维护整个项目的上下文、管理多个文件，并理解复杂的指令，从而构建强大的全栈应用。

主要功能包括：

  • 上下文感知：保留之前提示和文件状态的上下文。
  • 多文件管理：处理多个文件之间的依赖关系。
  • 经验证的执行：验证代码更新，以减少幻觉。

全栈功能

Google AI Studio 充分发挥了现代 Web 生态系统的强大功能，让您不仅可以构建客户端原型，还可以构建更多内容。

  • 服务器端运行时和 npm：使用庞大的 npm 软件包库。智能体会根据应用的需求（例如，用于数据可视化或 API 客户端的特定库）自动识别并安装软件包。您还可以根据需要请求特定软件包。
  • Secret 管理：在设置菜单中安全地存储 API 密钥和 Secret。这些密钥可在服务器端代码中访问，从而避免在客户端泄露。
  • 多人游戏：直接在 AI Studio 中构建实时协作体验。服务器端运行时管理用户进行互动所需的状态和连接。
  • Firebase Firestore 和 Authentication：自动预配和设置 Firebase，包括 Firestore 数据库（永久性数据存储区）和 Firebase Authentication（登录流程，特别是“使用 Google 账号登录”）。该智能体负责管理整个设置过程，甚至会为这些服务在您的应用中编写代码。
  • Google Workspace 集成：将您的应用连接到 Gmail、Google 表格、Google 文档、Google 云端硬盘、Google 日历等 Google Workspace API。AI Studio 会自动处理所有 OAuth 配置。

详细了解如何开发全栈应用

Android 应用

您还可以使用 Kotlin 和 Jetpack Compose 构建原生 Android 应用。 在基于浏览器的 Android 模拟器中预览应用，使用浏览器中的 ADB 将其安装到实体设备上，然后发布到 Play 商店进行内部测试。

AI Studio 还与 Firebase 集成，可为 Android 应用自动预配 Firebase AI Logic 和 Firebase App Check（用于在不公开原始 API 密钥的情况下安全地进行客户端 Gemini API 调用），以及 Cloud Firestore 和 Firebase Authentication。

详细了解如何构建 Android 应用

继续构建

Google AI Studio 为您的应用生成初始代码后，您可以继续对其进行优化：

在 Google AI Studio 中构建

  • 使用 Gemini 进行迭代：使用构建模式中的对话面板，问问 Gemini 进行修改、添加新功能或更改样式。
  • 直接修改代码：在预览面板中打开“代码”标签页，即可进行实时修改。

在外部开发

对于更高级的工作流，您可以同步或导出代码，以便在您偏好的环境中工作：

  • 与 GitHub 同步：将应用连接到 GitHub 代码库，以启用双向同步。您可以将 AI Studio 中提示的更改直接推送到代码库，并附上 AI 生成的提交消息，也可以将 IDE 中本地进行的更改或团队成员所做的更改拉取回 AI Studio。您可以随时在“设置”中的 GitHub 标签页内管理同步状态。
  • 下载并在本地开发：将生成的代码导出为 ZIP 文件，并将其导入到代码编辑器中。

主要特性

Google AI Studio 包含多项功能，可让构建过程直观且可视化：

  • 创建和迭代全栈应用：只需一条提示即可创建全栈应用，并通过对话或注释模式进行迭代。在注释模式下，您可以突出显示应用界面的任何部分，并描述您想要的更改。
  • 分享和部署应用：您可以与他人分享您的作品，以便开展协作或展示您的作品。共享时，API 调用会计入您的用量限额。如果您使用付费模型，可能需要支付费用。然后，当应用准备就绪后， 将其部署到 Cloud Run。
  • 应用库：应用库提供了一个可视化项目创意库。您可以浏览 Gemini 的各种功能，即时预览应用，并对其进行修改，打造专属应用。

部署或归档应用

应用准备就绪后，您就可以进行部署了：

  • Cloud Run：将应用部署为可扩缩的服务。 Google Cloud Run 可能会根据用量收取费用。如需详细了解部署，请参阅从 Google AI Studio 部署。

  • GitHub：将项目与新的或现有的 GitHub 代码库同步，以管理源代码或与团队成员协作。

限制

本部分列出了 Google AI Studio 中构建模式的当前限制。

API 密钥管理

当您创建使用 Gemini API 的新 Web 应用时，AI Studio 会自动将 Gemini API 密钥配置为应用服务器端环境中的密钥。您可以在密钥面板中查看和管理此密钥。

  • 自动设置：系统会为您设置 GEMINI_API_KEY，无需手动配置即可开始构建。
  • 仅限服务器端：API 密钥会注入到服务器端运行时中，绝不会包含在客户端代码中。
  • 现有应用：对于在 2026 年 5 月 14 日之前构建的应用，下次您修改应用的 Gemini 功能时，智能体会自动将您的 Gemini API 集成升级到推荐的服务器端方法。

Android 应用

在构建 Android 应用时，AI Studio 使用 Firebase AI Logic 和 Firebase App Check，而不是原始 API 密钥，因此凭据绝不会嵌入到 APK 中。

在 Google AI Studio 之外进行部署

  • Cloud Run：从 AI Studio 部署到 Cloud Run 时，您的 API 密钥会安全地包含在服务器端环境中。部署的应用将使用您的 API 密钥来处理所有用户的 Gemini API 调用。
  • ZIP 下载：如果您将应用下载为 ZIP 文件以在其他位置运行，则需要在托管环境中设置 GEMINI_API_KEY 环境变量。由于应用的 Gemini API 调用是通过服务器端代码发出的，因此密钥不会向最终用户公开。

分享应用时出错

如果您分享了应用，而最终用户在使用分享的网址时遇到 403 访问受限错误，则可能是由于以下原因之一：

  • 浏览器扩展程序：Privacy Badger 等隐私保护扩展程序可能会屏蔽该应用。请停用此类扩展程序，以免出现此错误。
  • 构建问题：当前代码可能存在问题。提示代理“修复当前代码的所有构建问题”，然后重新分享网址。

常见问题解答

什么是“在 AI Studio 中构建”？

AI Studio Build 是一个平台，旨在帮助您使用 Gemini 从简单的提示开始，构建可用于生产环境的 AI 赋能应用。通过提示描述您想构建的应用，Gemini 就会为您生成应用。您还可以探索我们的库，了解 Gemini API 的功能，并对应用进行改写，使其成为您自己的应用。

Build 如何处理我的 Gemini API 密钥？

当您创建使用 Gemini API 的 Web 应用时，AI Studio 会自动将您的 Gemini API 密钥设置为服务器端密钥。应用的 Gemini API 调用是通过服务器端代码使用此密钥发出的，因此绝不会在浏览器中公开。您可以在“设置”中的密钥面板中查看 API 密钥。对于 Android 应用，AI Studio 使用 Firebase AI Logic 和 Firebase App Check 进行安全的客户端调用，而无需在应用二进制文件中嵌入 API 密钥。

分享应用时，我的 API 密钥会泄露吗？

不会。您的 API 密钥会存储为服务器端 Secret，绝不会包含在客户端代码中。当您分享应用时，其他用户可以使用该应用，但无法看到您的 API 密钥。

与他人共享应用时，API 调用会计入用量限额。 如果您使用付费模型，可能需要支付费用。在设置期间以及分享之前，如果您的应用可能会产生费用，AI Studio 会向您发出提醒。

谁可以看到我的应用？

默认情况下，您的应用是不公开的。您可以与其他用户共享您的应用，以便他们使用。与您共享应用的用户可以查看其代码，并根据自己的目的对其进行分支。如果您在分享应用时授予了编辑权限，其他用户便可以修改应用的代码。

我可以在 AI Studio 之外运行应用吗？

可以。您可以从 AI Studio 将应用部署到 Cloud Run，这样您的应用就会获得一个公开网址，并且您的 API 密钥会在服务器端环境中安全配置。您也可以将应用下载为 ZIP 文件，并将其托管在其他位置，但您需要在托管环境中设置 GEMINI_API_KEY 环境变量。由于 Gemini API 调用是通过服务器端代码发出的，因此您的密钥会保持安全。

如需详细了解部署选项，请参阅从 Google AI Studio 部署。

我可以使用自己的工具在本地开发应用，然后在此处分享吗？

可以。您可以将 AI Studio 应用连接到 GitHub 代码库，以便使用您偏好的代码编辑器或 CLI 工具在本地进行开发，将更改推送到 GitHub，然后使用“设置”中的 GitHub 标签页将这些更新直接拉取回 AI Studio。

如何将数据库或其他存储空间与我的应用搭配使用？

AI Studio 应用是在 Cloud Run 容器中运行的标准应用。您可以使用可通过网络连接到的任何存储解决方案，只要没有防火墙阻止来自动态 IP 范围的访问即可。

我们正在努力在未来添加对存储空间的直接支持，您将能够直接在 AI Studio 中进行配置。

为确保观看者知道应用会使用其网络摄像头或其他设备，我们要求应用在访问这些 Navigator API 之前，必须先获得额外的确认。 应用创建者可以将这些权限请求添加到其应用的 metadata.json 文件中。例如：

{
  "name": "My app",
  "requestFramePermissions": [
    "microphone",
    "camera",
    "display-capture",
    "geolocation",
    "bluetooth",
    "clipboard-read",
    "serial",
    "usb"
  ]
}

requestFramePermissions 支持的值是标准由政策控制的功能的子集。

如何将 GitHub 与我的应用搭配使用？

AI Studio 支持与 GitHub 进行双向同步：

  • 导入代码库：在“构建”模式下，从提示输入框中的添加文件（+ 图标）菜单中选择从 GitHub 导入，以导入现有代码。
  • 关联代码库：在“设置”中，打开 GitHub 标签页，以便通过应用创建新的 GitHub 代码库或关联到现有代码库。
  • 双向同步：将 AI Studio 中提示的更改直接推送到代码库，并附带 AI 生成的提交消息；或将外部更改（例如本地 IDE 修改或团队成员的拉取请求）拉取回 AI Studio。
  • 解决合并冲突：如果与 GitHub 同步时发生更改冲突，AI Studio 会提供解决冲突对话框，其中包含并排差异查看器，可让您查看差异并选择是为每个冲突文件保留 AI Studio 版本还是 GitHub 版本。

我可以向其他用户授予应用的编辑权限吗？

AI Studio 不支持直接进行实时协作编辑。 不过，您可以通过将应用关联到共享的 GitHub 代码库，与团队成员协作。团队成员可以在 GitHub 上推送更改或发起拉取请求，而您可以将这些更新拉取到 AI Studio 中。

为什么我的应用被标记为违规？

我们有专门的系统来自动审核应用，以确保其符合我们的政策。如果我们发现某个应用违反了我们的政策，该应用将从 AI Studio 中移除。违规行为可能包括但不限于以下行为：

  • 应用包含恶意软件、钓鱼式攻击或假冒行为
  • 应用展示或分发违反“儿童性虐待影像”政策的内容
  • 应用展示或分发违反骚扰政策的内容
  • 应用展示或分发违反仇恨言论政策的内容
  • 应用展示或分发违反人口贩卖政策的内容
  • 应用展示或分发违反露骨色情内容政策的内容
  • 应用展示或分发违反“暴力和血腥内容”政策的内容
  • 应用展示或分发违反有害或危险内容政策的内容

如果您的应用因违反政策而被标记，而您认为该标记有误，可以提交申诉。屡次违反我们的政策可能会导致您无法再使用 AI Studio。

作为应用开发者，我需要承担哪些责任？

请注意，作为应用的所有者，您要对应用的行为及其处理的所有数据负责。其中包括：

  • 法律合规性和第三方权利：确保您的应用符合所有适用的法律法规，并且不侵犯他人的权利，包括知识产权和隐私权。
  • 内容监控：遵守附加条款可能适用于应用使用的其他服务。例如，适用于 Firestore 的 Google Cloud 服务条款要求托管第三方内容的客户发布政策，定义哪些内容属于禁止内容（例如非法内容），并监控是否存在此类非法内容。
  • 安全实现：实施必要的安全措施和审核工具，防止应用被滥用。

请注意服务条款中的使用限制。

除非另有说明，否则《Gemini API 附加服务条款》适用于 AI Studio 中应用库内展示的应用。

后续步骤