À propos des espaces de travail Firebase Studio

Firebase Studio fournit un environnement de développement collaboratif basé sur le cloud qui simplifie le processus de création d'applications avec une vaste combinaison de frameworks et de bibliothèques.

Une fois que vous avez configuré un espace de travail Firebase Studio, vous pouvez accéder à un environnement de développement flexible et entièrement fonctionnel, et le partager : les espaces de travail Firebase Studio sont accessibles depuis n'importe quel appareil et fournissent des outils intégrés pour rationaliser le processus de développement pour vous et votre équipe.

Créer un espace de travail

Dans Firebase Studio, un espace de travail est un environnement de développement qui contient tout ce dont vous avez besoin pour développer votre application. Il contient votre code, un éditeur de code (avec des plug-ins adaptés à votre projet) et des chaînes d'outils qui prennent en charge le développement d'applications. C'est comme créer un projet dans votre environnement de développement de bureau local, sauf que vous disposez d'un ordinateur et d'un système d'exploitation entiers préconfigurés et dédiés exclusivement à la création de votre application, exécutée dans votre navigateur dans le cloud et accessible où que vous soyez.

Les espaces de travail Firebase Studio sont optimisés pour contenir un seul codebase. Vous pouvez ainsi isoler les environnements et les dépendances au niveau du système de différentes applications les uns des autres. Vous pouvez créer plusieurs espaces de travail à utiliser avec différentes applications et différents frameworks.

Créer un espace de travail :

Dupliquer un espace de travail

Lorsque vous dupliquez un espace de travail Firebase Studio, une copie de votre projet est créée. Elle contient tout ce qui se trouve dans le répertoire home/user. Cela peut être utile lorsque vous souhaitez tester un projet sans affecter l'original ou lorsque vous souhaitez utiliser un projet existant comme point de départ pour un nouveau.

Pour forker un espace de travail :

  1. Sur la page d'accueil Firebase Studio, cliquez sur le menu  à côté de l'espace de travail que vous souhaitez copier > Fork.

  2. Saisissez le nom de votre nouvel espace de travail, puis cliquez sur Fork (Dupliquer). Le nouvel espace de travail est créé et ajouté à votre liste d'espaces de travail.

  3. (Facultatif) Si l'espace de travail d'origine est associé à un projet Firebase, envisagez de créer un projet Firebase distinct pour votre nouvel espace de travail. Cela empêche votre nouvel espace de travail d'apporter des modifications au projet Firebase associé à votre espace de travail d'origine. Pour créer un projet Firebase :

    1. Ouvrez le nouvel espace de travail et demandez à Gemini de créer un projet Firebase pour vous.
    2. Mettez à jour tous les fichiers qui font référence au projet Firebase, tels que .env ou .firebaserc.

Configurer votre espace de travail

Firebase Studio utilise Nix pour définir la configuration de l'environnement de chaque espace de travail. Nix est un gestionnaire de packages purement fonctionnel qui attribue des identifiants uniques à chaque dépendance. Cela signifie que votre environnement peut contenir plusieurs versions de la même dépendance, de manière transparente. Il est également reproductible et déclaratif. Dans le contexte de Firebase Studio, cela signifie que vous pouvez partager votre fichier de configuration Nix entre les espaces de travail pour charger la même configuration d'environnement. En savoir plus sur Nix + Firebase Studio

Créer ou modifier le fichier .idx/dev.nix

La configuration de l'environnement est définie dans le fichier .idx/dev.nix de votre dépôt de code. Ce fichier spécifie tous les composants à ajouter à votre espace de travail, y compris :

Consultez l'exemple de fichier .idx/dev.nix suivant pour obtenir une configuration d'environnement d'espace de travail de base qui permet les aperçus d'applications dans 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";
      };
    };
  };
}

Appliquer la nouvelle configuration

Chaque fois que vous ajoutez ou mettez à jour le fichier de configuration dev.nix, Firebase Studio affiche une invite dans l'angle inférieur droit pour recompiler l'environnement. Le temps nécessaire pour reconstruire l'environnement dépend du nombre de packages dont votre configuration a besoin.

Déboguer les échecs de compilation d'environnement

Comme les fichiers de configuration sont du code lisible par machine, ils peuvent contenir des erreurs. Dans ce cas, l'environnement peut ne pas être créé et ne pas démarrer. Firebase Studio affiche une option permettant de démarrer un environnement Recovery (Récupération). Cet espace de travail n'inclut aucune des configurations que vous avez définies et exécute uniquement les Code OSS de base. Cela vous permet de corriger les erreurs dans votre fichier de configuration dev.nix et de reconstruire l'environnement.

Étapes suivantes