О рабочих областях в Firebase Studio

Firebase Studio предоставляет совместную облачную среду разработки, которая упрощает процесс создания приложений с помощью обширного сочетания фреймворков и библиотек .

После настройки рабочего пространства Firebase Studio вы сможете получать доступ к полнофункциональной, гибкой среде разработки и совместно использовать ее: рабочие пространства Firebase Studio доступны с любого устройства и предоставляют интегрированные инструменты для оптимизации процесса разработки для вас и вашей команды.

Создать рабочее пространство

Рабочее пространство в Firebase Studio — это среда разработки, которая содержит всё необходимое для разработки вашего приложения. Оно содержит ваш код, редактор кода (с плагинами, соответствующими вашему проекту) и наборы инструментов для разработки приложений. Это похоже на создание нового проекта в локальной среде разработки, за исключением того, что у вас есть целый компьютер и операционная система, предварительно настроенные и предназначенные исключительно для разработки вашего приложения, работающие в вашем браузере в облаке и доступные вам, где бы вы ни находились.

Рабочие пространства Firebase Studio оптимизированы для работы с единой кодовой базой, что позволяет изолировать среды и системные зависимости различных приложений друг от друга. Вы можете создать несколько рабочих пространств для использования с различными приложениями и фреймворками.

Чтобы создать новое рабочее пространство:

Открытие шаблона или примера приложения .
Импорт проекта .
Создайте прототип с помощью ИИ , затем переключитесь в режим просмотра Code ( </> ).

Дублировать рабочее пространство

Дублирование рабочего пространства Firebase Studio создаёт копию вашего проекта, содержащую всё содержимое home/user каталога. Это полезно, когда вы хотите поэкспериментировать с проектом, не затрагивая исходный, или когда вы хотите использовать существующий проект в качестве отправной точки для нового.

Чтобы дублировать рабочее пространство:

На домашней странице Firebase Studio нажмите меню рядом с рабочей областью, которую вы хотите скопировать > Дублировать .
Введите имя нового рабочего пространства и нажмите «Дублировать» . Новое рабочее пространство будет создано и добавлено в ваш список рабочих пространств. Примечание: копирование больших рабочих пространств может занять несколько минут. Если новое рабочее пространство не загружается, подождите 5 минут, а затем обновите страницу.
(Необязательно) Если в исходном рабочем пространстве есть связанный проект Firebase, рассмотрите возможность создания отдельного проекта Firebase для нового рабочего пространства. Это предотвратит внесение изменений в проект Firebase, связанный с исходным рабочим пространством, из нового рабочего пространства. Чтобы создать проект Firebase:
1. Откройте новое рабочее пространство и попросите Gemini создать для вас проект Firebase.
2. Обновите все файлы, ссылающиеся на проект Firebase, например .env или .firebaserc .

Настройте свое рабочее пространство

Firebase Studio использует Nix для определения конфигурации среды для каждого рабочего пространства. Nix — это полностью функциональный менеджер пакетов, назначающий уникальные идентификаторы каждой зависимости, что в конечном итоге означает, что ваша среда может содержать несколько версий одной и той же зависимости без проблем. Кроме того, Nix является воспроизводимым и декларативным. В контексте Firebase Studio это означает, что вы можете использовать файл конфигурации Nix в разных рабочих пространствах для загрузки одной и той же конфигурации среды. Узнайте больше о Nix + Firebase Studio .

Создайте или отредактируйте файл `.idx/dev.nix`

Конфигурация среды определяется в файле .idx/dev.nix в вашем репозитории кода. В этом файле указаны все компоненты, которые будут добавлены в ваше рабочее пространство, включая:

Системные инструменты, доступные в реестре пакетов Nix , включая компиляторы, пакеты (например, go или angular ) и утилиты командной строки, такие как дополнительные компоненты gcloud CLI .
Расширения IDE из реестра OpenVSX , такие как отладчики для конкретных языков, средства форматирования кода, официальные расширения для облачных сервисов и многое другое.
Распространенные службы , такие как Docker, обмен сообщениями Pub/Sub, базы данных, такие как Postgres и Redis, и многое другое .

В следующем примере файла .idx/dev.nix представлена базовая конфигурация рабочей среды, которая позволяет просматривать предварительные просмотры приложений в Firebase Studio :

{ 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 и пересобрать среду.