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.

Chrome

1. Ouvrez les Paramètres.
2. Ouvrez l'onglet Confidentialité et sécurité.
3. Assurez-vous que l'option Autoriser tous les cookies est activée.
4. Accédez à idx.google.com.
5. Cliquez sur l'icône de visibilité dans la barre d'adresse. visibility_off pour ouvrir Panneau Protection contre le suivi Activez le le paramètre Cookies tiers pour autoriser temporairement aux cookies tiers. Les cookies sont activés sur IDX pendant 90 jours.

Safari

1. Ouvrez Safari > Paramètres...
2. Désactivez les paramètres suivants: <ph type="x-smartling-placeholder">
   </ph>
   • Paramètres avancés > Bloquer tous les cookies
   • Confidentialité > Empêcher le suivi intersites
3. Accédez à idx.google.com.

Firefox

Il n'est pas nécessaire d'activer les cookies tiers pour Firefox. Accédez à idx.google.com.

Opera

1. Accédez à idx.google.com.
2. Ouvrez le menu et cliquez sur Paramètres.
3. Accédez à la page Confidentialité et Sécurité, puis développez la section Cookies tiers.
4. Sélectionnez Bloquer les cookies tiers en mode navigation privée. Autoriser les cookies tiers
5. Accédez à idx.google.com.

Arc

1. Accédez à arc://settings.
2. Accédez à la section Confidentialité et sécurité, puis développez les Cookies tiers.
3. Sélectionnez Bloquer les cookies tiers en mode navigation privée. Autoriser les cookies tiers
4. Accédez à idx.google.com.

Rebelle

Vous n'avez pas besoin d'activer les cookies tiers pour Brave. Accédez à idx.google.com.

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.

Important :Le nombre d'espaces de travail que vous pouvez créer est limité. Si vous avez un Profil du développeur Google vous pouvez créer jusqu'à cinq espaces de travail. Créer directement un profil de développeur Google d'IDX une fois que vous avez atteint la limite de l'espace de travail, cliquez sur Complete Setup (Terminer la configuration). à partir de la notification du modèle de tableau de bord.

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.

Modèles

1. Parcourez les modèles par type d'application ou utilisez le champ de recherche situé en haut à droite pour filtrer l'intégralité de la bibliothèque de modèles mot clé. Espace de travail vide est disponible dans la catégorie Divers.

2. Attribuez un nom à votre espace de travail et définissez les éventuelles options supplémentaires.

3. Cliquez sur Créer. IDX crée un espace de travail basé sur vos sélectionnées.

N'hésitez pas à consulter de nouveau la page, car nous ajoutons constamment de nouveaux modèles ou dites-nous ce que vous souhaitez voir.

Importation d'un dépôt Git

1. Saisissez l'URL du dépôt. Le dépôt peut être hébergé sur GitHub, GitLab ou Bitbucket.

2. Cliquez sur Créer. IDX crée un espace de travail basé sur vos sélectionnées.

3. Pour les dépôts privés, vous serez invité à vous authentifier auprès du fournisseur concerné.

   • Pour GitHub, suivez les instructions pour copier un jeton d'accès.
   • Pour GitLab, vous pouvez utiliser le mot de passe de votre compte ou créer un jeton de compte personnel.
   • Pour Bitbucket, authentifiez-vous à l'aide de votre nom d'utilisateur (et non de votre adresse e-mail) et d'un mot de passe d'application.

4. Exécutez npm install (ou flutter pub get) dans le terminal IDX après lorsque vous importez votre projet. Par défaut, IDX n'installe pas npm les dépendances lorsque vous importez un projet.

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.