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

未启用第三方 Cookie。

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

  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?

Firebase Studio 需要启用第三方 Cookie,因为我们会在一个网域 (studio.firebase.google.com) 上呈现来自另一个网域(cloudworkstations.dev 的子网域)的 iframe,而第三方 Cookie 支持安全的跨源通信。

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

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

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

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

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

我的预览无法加载,但我找不到代码中存在任何问题。如何重启 Firebase Studio

如果 Firebase Studio 无法正常刷新(通常是由于进行重大重构或更改环境 dev.nix 文件所致),请打开命令 Palette(在 Mac 上为 Cmd+Shift+P,在 ChromeOS、Windows 或 Linux 上为 Ctrl+Shift+P),然后运行硬重启命令。如果这样做无法解决问题,请尝试运行重新构建环境命令。

在创建工作区时,我看到一条消息:“Oops...We need to start a new VM”(糟糕...我们需要启动新的虚拟机),之后界面挂起。

Firebase Studio 会维护一个用于按需预配工作区的虚拟机预热池。当池用量不足时,系统会在启动新的虚拟机后预配工作区。此过程可能需要一些时间(有时最多需要五分钟),但最终会成功。

创建工作区时,我收到内部错误消息。

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

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

Firebase Studio 免费方案每位用户最多只能创建三个工作区。加入 Google 开发者计划后,您最多可以创建 10 个工作区。如需升级到 30 个工作区,请订阅 Google 开发者高级计划

我的工作区已加载,但模拟器为空白。

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

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

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

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

我与某人分享了我的工作站网址,但对方看不到。

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

当我共享工作站时,协作者可以看到哪些内容?

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

我共享了工作区,为什么我的协作者无法发布或监控我的应用?

添加到您的 Workspace 的用户可能无权访问其底层 Firebase 项目,该项目为“应用概览”发布和监控功能提供支持。如需向他们授予对您的 Firebase 项目的访问权限,请参阅权限设置和 Firebase 项目访问权限

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

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

在将 Flutter 应用发布到 Firebase Hosting 时,我应选择哪个目标目录?

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

如何在我的 Workspace 中设置应用的后端,以便前端与其通信?

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

  1. 您可以在终端中手动启动后端或 API 服务器,也可以在 dev.nix 文件的预览配置或 onStart 生命周期钩子中启动后端或 API 服务器。

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

  3. 后端端口

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

  4. 点击端口号左侧的 锁形图标的图片 公开图标(锁形图标)。

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

  6. 现在,您可以直接从前端引用此网址(例如,使用 fetch 调用)。

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

使用 Ctrl+Shift+P(在 macOS 上,按 Cmd-Shift-P)打开命令面板,然后选择 Firebase Studio:显示 Android 预览Firebase Studio:显示 Web 预览

什么是 Code OSS?

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

如何阻止系统将我的代码补全和 Gemini 聊天提示用作训练数据?

使用 Firebase Studio 时,您必须遵守 Google 服务条款

不过,请注意,你在 Firebase Studio 中使用生成式 AI 功能时须遵守《生成式 AI 使用限制政策》Gemini API附加服务条款(具体而言,须遵守Gemini API附加服务条款:未付费服务)。

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

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

如果您在使用 Firebase Studio 时遇到问题或有功能请求,请与 Firebase 支持团队联系

我之前在 Firebase Studio 中使用过一项特定功能,但现在找不到它了。为什么它被移除了?

Firebase Studio 中的某些功能处于实验阶段。我们非常重视您的反馈,并会积极利用这些反馈来制定当前和计划中的功能集,定期移除未能达到您或我们的预期的功能。如果您希望在理想的 Firebase Studio 版本中看到某些功能,请向我们发送反馈。我们期待收到您的反馈!

我无法创建项目

预配 Gemini API 密钥等资源或部署到 Firebase App Hosting 时,系统会根据您的 Firebase Studio 工作区的名称自动为您预配项目。如果您收到“Failed to create a project”(未能创建项目)错误,请检查并确保您的工作区名称不包含特殊字符。Firebase 项目名称中只能使用字母、数字、引号、连字符、空格和感叹号。