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

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

Android 应用

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

详细了解如何构建 Android 应用

继续构建

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

在 Google AI Studio 中构建

  • 使用 Gemini 进行迭代：使用构建模式 中的聊天面板，要求 Gemini 进行修改、添加新功能或更改样式。
  • 直接修改代码：在预览面板中打开代码标签页以 进行实时修改。

在外部开发

对于更高级的工作流，您可以导出代码并在首选环境中工作：

  • 下载并在本地开发：将生成的代码导出为 ZIP 文件 ，然后将其导入到代码编辑器中。
  • 推送到 GitHub：将代码推送到 GitHub 代码库 ，以便将其与现有的开发和 部署流程集成。

主要特性

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

  • 创建和迭代全栈应用：只需 一个提示即可创建全栈应用，并通过聊天或注释模式进行迭代。借助注释模式，您可以突出显示应用界面的任何部分，并说明所需的更改。
  • 分享和部署应用：您可以与他人分享您的作品，以便进行 协作或展示您的作品。分享时，API 调用会计入您的使用量限制。如果您使用付费模型，可能会产生费用。然后，当您的应用准备就绪后，将其部署到 Cloud Run。
  • 应用媒体库：应用媒体库提供了一个项目想法的可视化库。 您可以浏览 Gemini 的功能，即时预览应用，并混搭应用以打造自己的应用。

部署或归档应用

应用准备就绪后，您可以部署它：

  • Cloud Run：将应用部署为可扩缩的服务。 Google Cloud Run 的价格可能会根据使用情况 而有所不同。如需详细了解部署，请参阅 从 Google AI Studio 进行部署。

  • GitHub：将项目导出到 GitHub 代码库。

限制

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

API 密钥管理

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

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

在 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 的功能，并混搭应用以打造自己的应用。

“构建”如何处理我的 Gemini API 密钥？

当您创建使用 Gemini API 的应用时，AI Studio 会自动将您的 Gemini API 密钥设置为服务器端密钥。应用的 Gemini API 调用是使用此密钥从服务器端代码发出的，因此绝不会在浏览器中公开。您可以在“设置”中的密钥 面板中查看 API 密钥。

分享应用时，我的 API 密钥是否会公开？

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

与他人分享应用时，API 调用会计入您的使用量限制。 如果您使用付费模型，可能会产生费用。如果您的应用可能会产生费用，AI Studio 会在设置期间和分享之前提醒您。

谁可以看到我的应用？

默认情况下，您的应用处于非公开状态。您可以与其他用户分享应用，让他们使用该应用。与您分享应用的用户可以看到应用的代码，并根据自己的需要进行派生。如果您分享应用时授予了修改权限，其他用户可以修改应用的代码。

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

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

如需详细了解部署选项，请参阅从 Google 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 代码库并提交最新更改。

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

目前尚不支持此功能，但即将推出。

为什么我的应用被标记为违反政策？

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

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

如果您的应用因违反政策而被标记，并且您认为这是错误的，可以提交申诉。屡次违反我们的政策可能会导致您无法再访问 AI Studio。

作为应用开发者，我的责任是什么？

提醒您，作为应用的所有者，您有责任对应用的行为及其处理的所有数据负责。其中包括：

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

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

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

后续步骤