Firebase Studio 工作区简介

Firebase Studio 提供了一个基于云端的协作开发环境，可通过广泛组合框架和库简化应用构建流程。

设置 Firebase Studio 工作区后，您可以访问并共享功能齐全且灵活的开发环境：Firebase Studio 工作区可从任何设备访问，并提供集成工具，帮助您和您的团队简化开发流程。

创建工作区

Firebase Studio 中的工作区是一个开发环境，其中包含开发应用所需的一切。它包含您的代码、代码编辑器（以及与您的项目相关的插件）和支持应用开发的工具链。这就像在本地桌面开发环境中创建新项目一样，只是您拥有一台预配置的计算机和操作系统，并且专门用于构建应用，通过浏览器在云端运行，无论您身在何处都可以访问。

Firebase Studio 工作区经过优化，可包含单个代码库，因此您可以将不同应用的环境和系统级依赖项彼此隔离开来。您可以创建多个工作区，以便与不同的应用和框架搭配使用。

要创建新工作区，请按以下步骤操作：

打开模板或示例应用。
导入项目。
使用 AI 开发原型，然后切换到 Code 视图 (</>)。

派生工作区

派生 Firebase Studio 工作区会创建项目副本，其中包含 home/user 目录中的所有内容。如果您想在不影响原始项目的情况下尝试使用某个项目，或者想使用现有项目作为新项目的起点，那么此功能非常有用。

如需派生工作区，请执行以下操作：

在 Firebase Studio 首页中，点击要复制的工作区旁边的菜单 > 复刻。
输入新工作区的名称，然后点击复刻。系统会创建新工作区并将其添加到您的工作区列表中。

注意：派生较大的工作区可能需要几分钟时间。如果新工作区未加载，请等待 5 分钟，然后刷新页面。
（可选）如果原始工作区已关联 Firebase 项目，请考虑为新工作区创建单独的 Firebase 项目。这样可防止新工作区更改与原始工作区关联的 Firebase 项目。要创建 Firebase 项目，请执行以下操作：
1. 打开新工作区，然后让 Gemini 为您创建 Firebase 项目。
2. 更新引用 Firebase 项目的所有文件，例如 .env 或 .firebaserc。

配置工作区

Firebase Studio 使用 Nix 为每个工作区定义环境配置。Nix 是一个纯功能性软件包管理系统，可为每个依赖项分配唯一标识符，这最终意味着您的环境可以无缝包含同一依赖项的多个版本。它还具备可重复性和声明性特征。在 Firebase Studio 上下文中，这意味着您可以在工作区之间共享 Nix 配置文件，以加载相同的环境配置。详细了解 Nix + Firebase Studio。

创建或修改 `.idx/dev.nix` 文件

环境配置在代码库的 .idx/dev.nix 文件中定义。此文件指定要添加到工作区中的所有组件，包括：

系统工具（可从 Nix 软件包注册表中获取），包括编译器、软件包（如 go 或 angular），以及命令行实用程序（如额外的 gcloud CLI 组件）。
来自 OpenVSX 注册表的 IDE 扩展程序，例如特定语言的调试器、代码格式化工具、云服务官方扩展程序等。
常见服务，例如 Docker、Pub/Sub 消息传递、Postgres 和 Redis 等数据库，以及其他服务。

如需查看在 Firebase Studio 中启用应用预览的基本工作区环境配置，请参阅以下示例 .idx/dev.nix 文件：

{ pkgs, ... }: {

  # Which nixpkgs channel to use.
  channel = "stable-23.11"; # or "unstable"

  # Use https://search.nixos.org/packages to find packages
  packages = [
    pkgs.nodejs_20
  ];

  # Sets environment variables in the workspace
  env = {
    SOME_ENV_VAR = "hello";
  };

  # Search for the extensions you want on https://open-vsx.org/ and use "publisher.id"
  idx.extensions = [
    "angular.ng-template"
  ];

  # Enable previews and customize configuration
  idx.previews = {
    enable = true;
    previews = {
      web = {
        command = [
          "npm"
          "run"
          "start"
          "--"
          "--port"
          "$PORT"
          "--host"
          "0.0.0.0"
          "--disable-host-check"
        ];
        manager = "web";
        # Optionally, specify a directory that contains your web app
        # cwd = "app/client";
      };
    };
  };
}

应用新配置

每当您添加或更新 dev.nix 配置文件时，Firebase Studio 都会在右下角显示一个提示，提示您重新构建环境。重新构建环境所需的时间取决于配置所需的软件包数量。

调试环境构建失败

由于配置文件是机器可读的代码，因此可能会出现错误。如果发生这种情况，环境可能构建失败并无法启动。Firebase Studio 显示用于启动一个恢复环境的选项。此工作区不包含您定义的任何配置，仅运行基本的 Code OSS 作为临时修复环境。这样一来，您就有机会修正 dev.nix 配置文件中的错误并重新构建环境。