Sobre os espaços de trabalho do Firebase Studio

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

Depois de configurar um espaço de trabalho do Firebase Studio, é possível acessar e compartilhar um ambiente de desenvolvimento flexível e totalmente funcional: os espaços de trabalho do Firebase Studio podem ser acessados em qualquer dispositivo e contam com 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 de que você precisa para desenvolver seu aplicativo. Ele contém seu código, um editor de código (com plug-ins relevantes para o projeto) e conjuntos de ferramentas compatíveis com o desenvolvimento de aplicativos. É como criar um novo projeto no seu ambiente de desenvolvimento pelo computador local, com a diferença que você tem um computador inteiro com um sistema operacional pré-configurado e dedicado exclusivamente para criar seu aplicativo, em execução pelo navegador na nuvem, acessível onde você estiver.

Os espaços de trabalho do Firebase Studio são otimizados para conter uma única base de código, para que você possa manter isolados uns dos outros os ambientes e as dependências do sistema para diferentes aplicativos. É 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. Ou seja, seu ambiente pode conter várias versões da mesma dependência de forma integrada. Ele também é reproduzível e declarativo. Por isso, no contexto do Firebase Studio, é possível compartilhar seu arquivo de configuração do Nix com outros espaços de trabalho para que carreguem a mesma configuração de ambiente. Saiba mais sobre o Nix com o 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 a seguir o exemplo de arquivo .idx/dev.nix para uma configuração básica do ambiente de espaço de trabalho que ativa as prévias do aplicativo no 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ê adiciona ou atualiza o arquivo de configuração dev.nix, o Firebase Studio exibe 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 ao criar ambiente

Como os arquivos de configuração são códigos legíveis por máquina, eles podem conter erros. Se isso acontecer, talvez não seja possível criar e iniciar o ambiente. O Firebase Studio mostra uma opção para iniciar um ambiente de Recuperação. Esse espaço de trabalho não tem as configurações que você definiu e executa apenas o Code OSS básico. Isso permite corrigir erros no arquivo de configuração dev.nix e recriar o ambiente.

Próximas etapas