Sobre os espaços de trabalho do Firebase Studio

O Firebase Studio oferece um ambiente de desenvolvimento colaborativo baseado na nuvem que simplifica o processo de criação de aplicativos com uma ampla combinação de frameworks e bibliotecas.

Depois de configurar um espaço de trabalho Firebase Studio, você pode acessar e compartilhar um ambiente de desenvolvimento flexível e totalmente funcional: os espaços de trabalho Firebase Studio podem ser acessados em qualquer dispositivo e oferecem ferramentas integradas para agilizar o processo de desenvolvimento da sua equipe.

Criar um espaço de trabalho

Um espaço de trabalho no Firebase Studio é um ambiente de desenvolvimento que contém tudo o que você precisa para desenvolver seu aplicativo. Ele contém seu código, um editor de código (com plug-ins relevantes para seu projeto) e toolchains que oferecem suporte ao desenvolvimento de apps. É como criar um novo projeto no seu ambiente de desenvolvimento de computador local, exceto que você tem um computador inteiro e um sistema operacional pré-configurado e dedicado exclusivamente para criar seu aplicativo, em execução no navegador na nuvem, acessível em qualquer lugar que você estiver.

Os espaços de trabalho Firebase Studio são otimizados para conter uma única base de código, para que você possa manter os ambientes e as dependências do sistema de diferentes aplicativos isolados uns dos outros. É possível criar vários espaços de trabalho para usar com diferentes aplicativos e frameworks.

Para criar um novo espaço de trabalho:

Configurar seu espaço de trabalho

O Firebase Studio usa o Nix para definir a configuração do ambiente para cada espaço de trabalho. O Nix é um gerenciador de pacotes puramente funcional e atribui identificadores exclusivos a cada dependência, o que significa que seu ambiente pode conter várias versões da mesma dependência de forma integrada. Ele também é reproduzível e declarativo. No contexto de Firebase Studio, isso significa que você pode compartilhar seu arquivo de configuração do Nix entre os espaços de trabalho para carregar a mesma configuração de ambiente. Saiba mais sobre o Nix + Firebase Studio.

Criar ou editar o arquivo .idx/dev.nix

A configuração do ambiente é definida no arquivo .idx/dev.nix no repositório de código. Esse arquivo especifica todos os componentes a serem adicionados ao espaço de trabalho, incluindo:

Confira o exemplo de arquivo .idx/dev.nix abaixo para uma configuração básica de ambiente de espaço de trabalho que ativa as prévias do app em 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";
      };
    };
  };
}

Aplicar nova configuração

Sempre que você adicionar ou atualizar o arquivo de configuração dev.nix, o Firebase Studio vai mostrar um aviso no canto inferior direito para Recriar o ambiente. O tempo necessário para recriar o ambiente depende do número de pacotes necessários para a configuração.

Depurar falhas de build do ambiente

Como os arquivos de configuração são códigos legíveis por máquina, eles podem ter erros. Se isso acontecer, o ambiente pode não ser criado e não ser iniciado. Firebase Studio mostra uma opção para iniciar um ambiente de Recuperação. Esse espaço de trabalho não inclui nenhuma configuração definida e executa apenas Code OSS básico. Isso permite corrigir erros no arquivo de configuração dev.nix e recriar o ambiente.

Próximas etapas