Premiers pas avec le projet IDX

Poursuivez votre lecture pour découvrir les principes de base à connaître pour commencer à utiliser Project IDX.

Avant de commencer

Avant de commencer, vous devrez peut-être activer les cookies tiers pour votre navigateur. Project IDX nécessite des cookies tiers dans la plupart des navigateurs pour authentifier les espaces de travail.

Créer un espace de travail

Dans IDX, un espace de travail est un environnement de développement qui contient tout dont vous avez besoin pour développer votre application. Elle contient votre code, un éditeur de code (avec des plug-ins adaptés à votre projet) et des chaînes d'outils compatibles avec les applications développement d'applications. Il est similaire à vous créez un nouveau projet dans votre environnement de développement local, d'un ordinateur et d'un système d'exploitation préconfigurés et dédiés exclusivement à la création d'une application.

Les espaces de travail Project IDX sont optimisés pour contenir un codebase à la fois, Vous pouvez ainsi conserver les environnements et les dépendances au niveau du système et d'isoler des applications les unes des autres.

Si vous créez une application, utilisez les modèles Workspace gérés dans IDX pour commencer rapidement. Vous pouvez également importer votre application existante en IDX.

Pour créer un espace de travail, procédez comme suit:

1. Ouvrez Project IDX.

2. La première fois que vous ouvrez IDX, vous êtes invité à lire et à accepter les les conditions d'utilisation des produits Google, de l'IA générative et du SDK Android. Vous pouvez également choisir de recevoir des communications sur les mises à jour des produits et des annonces ou des études utilisateur pour améliorer notre produit. Sélectionnez les options qui ont du sens pour vous. Cliquez sur les liens fournis pour lire les conditions d'utilisation, puis sélectionnez l'option pour les accepter, puis cliquez sur Continuer. Ensuite, vous pouvez décider Activez les fonctionnalités d'IA dès votre première utilisation d'IDX ou arrêtez-les en cliquant sur Pas maintenant (vous pouvez toujours les activer plus tard). Si vous les activez sur cet écran, consultez les sur l'IA et la confidentialité, puis cliquez sur Continuer pour conserver vos paramètres ou Retournez pour désactiver les fonctionnalités d'IA.

3. Sélectionnez le type d'espace de travail que vous souhaitez créer:

   • Modèles:créez un espace de travail préchargé avec les fichiers de base et packages dont vous pourriez avoir besoin. Sélectionnez l'un des modèles proposés ou cliquez sur Voir tous les modèles pour obtenir la liste complète des frameworks, API, et langues. Vous trouverez également le modèle Espace de travail vide dans la bibliothèque de modèles.
   • Dépôt Git:sélectionnez Importer un dépôt pour cloner un dépôt dans votre espace de travail.

Configurer votre espace de travail

IDX utilise Nix pour définir la configuration de l'environnement pour chaque espace de travail. Nix est une application et attribue des identifiants uniques à chaque dépendance, ce qui signifie que votre environnement contenir plusieurs versions de la même dépendance, de manière transparente. Il est également reproductibles et déclaratives. Dans le contexte d'IDX, cela signifie que vous pouvez partagez votre fichier de configuration Nix entre les espaces de travail pour charger le même configuration de l'environnement. En savoir plus sur Nix + IDX

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 code un dépôt de clés. Ce fichier vous permet de spécifier les packages qui sont installés, l’environnement et les extensions Code OSS.

Consultez l'exemple de fichier .idx/dev.nix suivant pour un environnement d'espace de travail de base configuration qui active les aperçus d'application dans IDX:

{ pkgs, ... }: {

  # Which nixpkgs channel to use.
  channel = "stable-23.11"; # or "unstable"

  # Use https://search.nixos.org/packages to find packages
  packages = [
    pkgs.nodejs_18
  ];

  # 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";
      };
    };
  };
}

Appliquer la nouvelle configuration

Chaque fois que vous ajoutez ou mettez à jour le fichier de configuration dev.nix, IDX affiche l'invite Recompiler l'environnement en bas à droite. Le temps nécessaire pour reconstruire l'environnement dépend du nombre de packages vos besoins de configuration.

Déboguer les échecs de compilation de l'environnement

Étant donné que les fichiers de configuration sont du code exploitable par un ordinateur, ils peuvent contenir des erreurs. Dans ce cas, la compilation de l'environnement peut échouer et ne pas démarrer. IDX affiche une option permettant de démarrer un environnement de récupération. Cet espace de travail inclut l'une des configurations que vous avez définies et exécute uniquement Code OSS. Vous pourrez ainsi corriger les erreurs dans votre dev.nix de configuration Terraform et recompilez l'environnement.

IDX finira par détecter les erreurs de compilation de l'environnement. Pour l'instant, vous vous devrez dépanner par vous-même.

Étapes suivantes

• Prévisualisez votre application.

• Partagez votre espace de travail.