Firebase Studio 工作区简介

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

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

创建工作区

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

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

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

复制工作区

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

如需复制工作区，请执行以下操作：

  1. 在 Firebase Studio 首页中，点击要复制的工作区旁边的 菜单 > 复制。

  2. 为新工作区输入一个名称，然后点击复制。系统会创建新工作区并将其添加到您的工作区列表中。 ß 注意：复制较大的工作区可能需要几分钟时间。如果新工作区未加载出来，请等待 5 分钟，然后刷新页面。

  3. （可选）如果原始工作区已关联 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 文件中定义。此文件指定要添加到工作区中的所有组件，包括：

如需查看在 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 配置文件中的错误并重新构建环境。

后续步骤