Firebase Studio 问题排查和常见问题解答

如何从 Firebase Studio 下载我的文件？

如需将文件下载为 zip 文件，请执行以下操作：

  • 在“探索器”窗格中右键点击任意目录，然后选择压缩并下载。

如需下载项目目录中的所有内容，请执行以下操作：

  1. 选择文件 > 打开文件夹。

  2. 接受默认的 /home/user 目录。

  3. 文件加载完毕后，右键点击工作目录，然后选择压缩并下载。如果使用 App Prototyping agent，您的工作目录将是 studio。如果使用的是模板或已上传的项目，则此处将显示项目名称。

  4. 当系统提示您重新构建环境时，点击取消。

  5. 下载完成后，从文件菜单中重新打开工作目录，以返回到工作区。

未启用第三方 Cookie。

在开始之前，您可能需要为浏览器启用第三方 Cookie。Firebase Studio 需要在大多数浏览器中使用第三方 Cookie 来对工作区进行身份验证。

ChromeSafariFirefoxOpera弧形Brave
  1. 打开设置。
  2. 打开隐私与安全标签页。
  3. 确保已启用允许所有 Cookie。
  4. 打开 Firebase Studio。
  5. 点击地址栏中的可见性图标 visibility_off，打开跟踪保护面板。开启第三方 Cookie 设置，以暂时允许第三方 Cookie。这会在 Firebase Studio 上启用 90 天的 Cookie。
  1. 打开 Safari > 设置…。
  2. 关闭以下设置：
    • 高级 > 阻止所有 Cookie
    • 隐私设置 > 阻止跨网站跟踪
  3. 打开 Firebase Studio。

您无需为 Firefox 启用第三方 Cookie。 打开 Firebase Studio。

  1. 打开 Opera。
  2. 打开菜单，然后点击设置。
  3. 前往隐私与安全部分，然后展开第三方 Cookie 选项。
  4. 选择在无痕模式下阻止第三方 Cookie 或允许第三方 Cookie。
  5. 打开 Firebase Studio。
  1. 前往 arc://settings。
  2. 前往隐私与安全部分，然后展开第三方 Cookie 选项。
  3. 选择在无痕模式下阻止第三方 Cookie 或允许第三方 Cookie。
  4. 打开 Firebase Studio。

您无需为 Brave 启用第三方 Cookie。打开 Firebase Studio。

为什么 Firebase Studio 需要启用第三方 (3P) Cookie？

由于我们在另一个网域 (studio.firebase.google.com) 中呈现来自一个网域（cloudworkstations.dev 的子网域）的 iframe，因此 Firebase Studio 需要启用第三方 Cookie，而第三方 Cookie 可实现安全的跨源通信。

打开工作区时，系统会显示“无法将您的请求转发到后端。无法通过端口 80 连接到服务器。”消息。

等待大约 5 秒钟，然后刷新页面。

如何查看自动生成的 Gemini API 密钥的每分钟请求配额？

了解 Gemini API 的速率限制和配额。

您可以在 Google Cloud 控制台的Generative Language API 配额和系统限制页面上查看与您的自动生成 API 密钥关联的配额。

我的预览无法加载，但我在代码中无法发现任何问题。如何重启 Firebase Studio？

如果 Firebase Studio 无法正常刷新（通常是由于进行了重大重构或更改了环境 dev.nix 文件所致），请打开命令面板（在 Mac 上为 Cmd+Shift+P，在 ChromeOS、Windows 或 Linux 上为 Ctrl+Shift+P）并运行 Hard Restart 命令。如果这样做无法解决问题，请尝试运行 Rebuild Environment 命令。

在创建工作区时，我看到一条消息“糟糕…我们需要启动新的虚拟机”，然后界面会卡住。

Firebase Studio 会维护一个虚拟机暖池，用于按需预配工作区。当池中的空闲工作区数量不足时，系统会在启动新虚拟机后预配工作区。此过程可能需要一些时间（有时长达五分钟），但最终会成功。

创建工作区时，我收到“发生内部错误”的提示。

在工作区预配期间发生内部错误的大多数情况下，大约一分钟后刷新页面即可解决错误并进入工作区。

我可以创建多少个工作区？

Firebase Studio 免费方案允许每位用户最多可以创建三个工作区。您可以加入 Google Developer Program，将可创建的工作区数量增加至最多 10 个。如需升级到 30 个工作区，请订阅 Google Developer Premium Program。

我的工作区已加载，但模拟器是空白的。

我们正在积极提高云端模拟器的可靠性。如果刷新页面无法解决问题，请向 Firebase 支持团队报告问题。

一些 Firebase Studio 工作区具有与我的项目不兼容的 Flutter 版本。

您可以像在本地机器上一样（使用 apt-get 或 brew），在工作区内升级或降级几乎所有预安装软件的版本。您可以在工作区中升级或降级软件，但安装的软件不会在各个会话之间保留。我们建议您在 dev.nix 文件中添加所有必需的软件包。

我们正在努力改进 Firebase Studio 中的 Flutter 版本管理。

我与他人共享了工作站网址，但对方无法看到该网址。

您只能与有权访问工作区的用户共享工作区网址。没有权限的用户在尝试访问该网址时会看到错误。请务必明确与其他用户共享工作区。

当我共享工作站时，协作者可以看到什么内容？

添加到工作区的用户可以完全访问虚拟机的整个文件系统，其中可能包含敏感文件，例如存储在磁盘上的私钥和访问令牌。仅与您信任的人员共享您的工作区。虽然此方法有助于其他用户查看您的工作区的精确状态，但这意味着他们会看到您工作区中的所有内容。

我已共享工作区；为什么协作者无法发布或监控我的应用？

添加到您的工作区中的用户可能没有权限访问其底层 Firebase 项目，而该项目为“应用概览”发布和监控功能提供支持。如需向其授予 Firebase 项目的权限，请参阅 Firebase 项目的权限和访问权限。

我可以使用 Firebase Studio 没有模板的框架来构建我的应用吗？

可以！您可以自定义环境，以便在 Firebase Studio 中使用几乎任何框架或语言。

将 Flutter 应用发布到 Firebase Hosting 时，我应该选择哪个目标目录？

选择 build/web 目录。此目录应包含 index.html，以及在 Web 应用成功构建（通过 flutter build web）后呈现该应用所需的所有静态资产。

如何在工作区中设置应用的后端，以便前端与其通信？

您可以暂时公开打开正在运行后端服务器的 TCP 端口，以便更轻松地在不同的工作区中分别开发前端和后端：

  1. 在终端中手动启动后端或 API 服务器，或作为 dev.nix 文件的预览配置或 onStart 生命周期钩子的一部分启动。

  2. 点击活动栏中的 Firebase Studio 图标（默认位于左侧），打开 Firebase Studio 面板。

  3. 后端端口

    展开后端端口部分，查看正在运行的服务器列表，包括其端口号和进程 ID (PID)。

  4. 点击端口号左侧的 锁形图标的图片 设为公开图标（一个锁）。

  5. 点击端口号右侧的 复制图标的图片 复制网址图标，复制其完全限定网址。

  6. 现在，您可以直接从前端引用此网址（例如，使用 fetch 调用）。

我关闭了预览标签页。如何恢复该标签页？

按 Ctrl+Shift+P（在 macOS 上，按 Cmd-Shift-P）打开命令面板，然后选择“Firebase Studio：显示 Android 预览”或“Firebase Studio：显示网页预览”。

什么是 Code OSS？

Code-Open Source Software (Code-OSS) 是一个开源项目，该项目是 VS Code 的核心层。Code-OSS 在 GitHub 上以标准 MIT 许可的形式提供，Microsoft 正是在其中开发 VS Code 产品。

如何阻止系统将我的代码补全和 Gemini 对话提示用作训练数据？

使用 Firebase Studio 时，您必须遵守《Google 服务条款》。

不过，请注意，使用 Firebase Studio 中的生成式 AI 功能受《生成式 AI 使用限制政策》和《Gemini API 附加服务条款》的约束（具体受《Gemini API 附加服务条款：免费服务》的约束）。

如要禁止使用您的提示和回答来训练模型，请勿使用 App Prototyping agent，也不要在 Firebase Studio 中使用 Gemini in Firebase。如需禁止使用您的代码进行模型训练，请在 Firebase Studio 设置中关闭代码补全和代码索引编制。

如何提交功能请求或针对遇到的问题提供反馈？

如果您在使用 Firebase Studio 时遇到问题或者希望提交功能请求，请与 Firebase 支持团队联系。

我在 Firebase Studio 中使用过某个特定功能，但现在找不到了。为什么它被移除了？

Firebase Studio 中的部分功能处于实验阶段。我们重视您的反馈，并会积极利用反馈来制定当前和计划中的功能集，并定期移除不符合您或我们期望的功能。如果您希望在理想的 Firebase Studio 版本中看到某些功能，请向我们发送反馈。我们期待听到您的反馈！

我无法创建项目

在预配 Gemini API 密钥等资源或部署到 Firebase App Hosting 时，系统会根据您的 Firebase Studio 工作区名称自动为您预配项目。如果您收到“未能创建项目”错误，请检查以确保您的工作区名称没有包含特殊字符。Firebase 项目名称中仅支持字母、数字、引号、连字符、空格和感叹号。