Dépannage et questions fréquentes sur le projet IDX

Lors de l'ouverture d'un espace de travail, le message suivant s'affiche : Impossible de transférer votre demande au backend. Impossible de se connecter à un serveur sur le port 80.

Il s'agit d'un problème connu. Pour contourner ce problème, attendez environ cinq secondes et actualisez la page.

Mon aperçu ne fonctionne pas, mais il n'y a rien d'anormal avec le code. Comment redémarrer IDX ?

Si IDX ne s'actualise pas correctement (généralement en raison de refactorisations majeures ou de modifications du fichier monospace.json), effectuez un redémarrage matériel, disponible dans la palette de commandes (Cmd+Maj+P sur Mac ou Ctrl+Maj+P sous ChromeOS, Windows ou Linux), sous la catégorie IDX.

Lors de la création d'un espace de travail, le message Oups. Nous devons lancer une nouvelle VM. L'interface utilisateur se bloque ensuite.

IDX gère un pool de VM tiède utilisé pour provisionner des espaces de travail à la demande. Lorsque le pool est presque épuisé, les espaces de travail sont provisionnés après le lancement d'une nouvelle VM. Le processus peut prendre du temps (jusqu'à 5 minutes), mais aboutit.

Lors de la création d'un espace de travail, le message Une erreur interne s'est produite s'affiche

Dans la plupart des cas d'erreurs internes lors du provisionnement de l'espace de travail, le fait d'actualiser la page au bout d'une minute environ devrait vous faire dépasser l'erreur et accéder à l'espace de travail.

Combien d'espaces de travail différents puis-je avoir sur mon compte ?

IDX est limité à un espace de travail par utilisateur. Si vous possédez un profil de développeur Google, vous pouvez créer jusqu'à cinq espaces de travail. Pour créer un profil de développeur Google directement à partir d'IDX une fois que vous avez atteint la limite d'espace de travail, cliquez sur Terminer la configuration dans la notification du modèle de tableau de bord.

Mon espace de travail se charge, mais l'émulateur est vide

Nous améliorons activement la fiabilité de nos émulateurs basés sur le cloud. Si le problème persiste après l'actualisation de la page, veuillez le signaler.

La version de Flutter des espaces de travail IDX n'est pas compatible avec mon projet.

Vous pouvez mettre à niveau ou revenir à une version antérieure de presque tous les logiciels préinstallés dans un espace de travail comme vous le feriez sur votre ordinateur local (à l'aide de apt-get ou brew). Notez que les modifications ne sont pas conservées lorsqu'un espace de travail "inactif" hiberne.

Quelle est la différence entre Project IDX et Google Cloud Workstations ?

Nous avons développé IDX sur l'offre Cloud Workstations (incroyable !) de Google Cloud en disponibilité générale. Cloud Workstations est une offre d'infrastructure axée sur la fiabilité, la sécurité et la disponibilité des stations de travail des développeurs. Il s'agit du choix idéal pour les grandes entreprises qui souhaitent gérer leur expérience de développement. Project IDX est un environnement "batteries incluses" dans ces stations de travail qui gère les chaînes d'outils, la pile de développement logiciel et les dépendances système requises pour créer différents types d'applications.

Je ne connais pas Linux. Comment devenir productif avec Project IDX ?

Project IDX expose une interface système Debian que vous pouvez utiliser pour installer et gérer les dépendances logicielles au niveau du système de votre projet. Nous allons bientôt passer à une interface système basée sur Nix, indépendante du système d'exploitation, que vous pouvez utiliser pour gérer les dépendances logicielles système en tant que configurations, sans comprendre les spécificités des gestionnaires de packages spécifiques au système d'exploitation, comme apt. Tenez-vous informé !

Pourquoi IDX nécessite-t-il l'activation des cookies tiers ?

Les cookies tiers doivent être activés pour IDX, car nous affichons un iFrame d'un domaine (un sous-domaine de cloudworkstations.dev) sur un autre domaine (idx.google.com), et les cookies tiers permettent une communication multi-origine sécurisée.

Vous ne pouvez partager une URL d'espace de travail qu'avec des utilisateurs qui y ont accès. Les utilisateurs non autorisés voient un message d'erreur s'afficher lorsqu'ils tentent d'accéder à l'URL. Veillez à partager explicitement l'espace de travail avec eux, par exemple en partageant un document Google Docs.

Les utilisateurs ajoutés à votre espace de travail ont un accès complet à l'ensemble du système de fichiers de la VM, qui peut contenir des fichiers sensibles tels que des clés privées et des jetons d'accès. Partagez votre espace de travail uniquement avec des personnes de confiance. Bien que cette approche aide les autres utilisateurs à voir l'état exact de votre espace de travail, ils peuvent tout voir.

Lorsque vous déployez vos applications sur Firebase à l'aide d'IDX, l'espace de travail n'est provisionné qu'avec les autorisations de base requises pour effectuer les opérations. Bien que vous puissiez, en tant qu'utilisateur, être administrateur de votre projet, l'espace de travail lui-même ne dispose pas de toutes les autorisations inhérentes au rôle de propriétaire, selon le principe du moindre privilège.

Puis-je utiliser des frameworks non compatibles avec IDX pour créer mon application ?

Oui ! Nous nous efforçons de rendre les espaces de travail entièrement personnalisables. Toutefois, il est tout à fait possible d'importer vos projets qui utilisent un framework d'interface non compatible ou qui ne disposent pas d'interface utilisateur du tout. Le moyen le plus simple d'y remédier consiste à sélectionner Other (Autre) comme App Type (Type d'application) dans le flux Import a repo (Importer un dépôt). Une fois que vous avez configuré votre espace de travail, vous pouvez installer toutes les dépendances au niveau du système dont votre projet a besoin.

Puis-je importer mon dépôt depuis un dépôt GitLab ou Cloud Source ?

Pour le moment, GitHub est compatible. Si vous souhaitez que nous acceptions d'autres hôtes Git, envoyez une demande de fonctionnalité.

En attendant, vous pouvez créer un espace de travail à partir d'un modèle existant et exécuter git clone avec n'importe quel hôte Git basé sur https ou ssh dans un terminal, comme vous le feriez normalement sur votre ordinateur local.

Quel répertoire cible dois-je sélectionner lors du déploiement d'une application Flutter sur Firebase Hosting ?

Sélectionnez le répertoire build/web. Ce répertoire doit contenir un index.html et tous les éléments statiques nécessaires pour afficher votre application Web une fois l'application créée (via flutter build web).

Comment configurer le backend de mon application sur mon espace de travail pour que mon interface puisse communiquer avec lui ?

Nous prévoyons de simplifier ce processus prochainement, mais pour l'instant, utilisez la solution suivante:

Les projets ayant un backend d'API peuvent démarrer leurs services d'API manuellement dans un terminal ou configurer la commande de démarrage dans le fichier monospace.json.
Ouvrez le port sur lequel le service d'API s'exécute pour que l'aperçu de votre interface Web puisse y accéder en exécutant le script bash suivant dans un terminal:
```
export port=4000 #dont use restricted ports (8000, 9000-9002)
export API_SERVICE="https://$port-$WEB_HOST"
echo $API_SERVICE
```
Ouvrez API_SERVICE URL au-dessus d'un nouvel onglet dans votre navigateur. Cela définit un cookie requis via un flux de redirection.
L'interface de votre application Web peut maintenant accéder au service d'API via le chemin d'accès complet.

J'ai fermé l'onglet "Aperçu". Comment puis-je le récupérer ?

Ouvrez la palette de commandes (Cmd+Maj+P sur Mac ou Ctrl+Maj+P sous ChromeOS, Windows ou Linux), puis sélectionnez Project IDX: Show Web Preview (ID du projet : Afficher l'aperçu Web).

Qu'est-ce que Code OSS ?

Code-Open Source Software (Code-OSS) est un projet Open Source qui constitue la couche centrale de VS Code. Code-OSS est disponible sur GitHub sous la licence standard MIT. C'est là que Microsoft développe le produit VS Code.

Comment empêcher la saisie semi-automatique de mon code et l'utilisation de mes requêtes de chat Gemini en tant que données d'entraînement ?

Si vous ne souhaitez pas que vos requêtes de chat Gemini soient utilisées en tant que données d'entraînement pour améliorer Gemini dans IDX, n'utilisez pas l'assistant de chat et désactivez la saisie automatique de code dans les paramètres de votre espace de travail.

Comment envoyer une demande de fonctionnalité ou des commentaires sur un problème rencontré ?

Si vous rencontrez un problème lors de l'utilisation de Project IDX, signalez-nous un bug.

Si vous souhaitez qu'une fonctionnalité soit ajoutée à IDX ou qu'une fonctionnalité existante soit étendue, envoyez une demande de fonctionnalité.

IDX utilise IssueTracker pour les bugs et les demandes de fonctionnalités, afin de répondre aux demandes urgentes avec des captures d'écran et des vidéos. À l'avenir, IDX suivra probablement les commentaires et les fonctionnalités via UserVoice. Tous les commentaires ou demandes déjà envoyés via UserVoice ont été conservés et partagés avec l'équipe.

Comment savoir si Gemini en IDX est disponible dans mon pays ou ma région ?

Gemini dans IDX n'est disponible que dans certaines régions, et sa disponibilité est régulièrement étendue. Si Gemini est disponible dans IDX dans votre région, vous pouvez l'ajouter à votre espace de travail en suivant les étapes décrites dans la section Ajouter Gemini à votre espace de travail.

J'utilisais une fonctionnalité particulière de Project IDX, mais je ne la trouve plus. Pourquoi ma vidéo a-t-elle été supprimée ?

Certaines des fonctionnalités de Project IDX sont expérimentales. Vos commentaires nous sont très utiles. Ils nous permettent d'élaborer notre ensemble de fonctionnalités actuel et prévu, et de supprimer régulièrement les fonctionnalités qui ne répondent pas à vos attentes ni aux nôtres. Si vous souhaitez que votre version idéale de Project IDX intègre des fonctionnalités, envoyez-nous vos commentaires. Votre avis nous intéresse !