Remarque
L’ouverture d’un dépôt dans github.dev l’ouvre dans VS Code for the Web, la version accessible dans le navigateur de VS Code. Pour plus d’informations, consultez VS Code for the Web la VS Code documentation.
À propos de VS Code for the Web
VS Code for the Web est une expérience d’édition légère qui s’exécute entièrement dans votre navigateur. Avec VS Code for the Web, vous pouvez parcourir les fichiers et les référentiels de code source à partir de GitHub, et apporter et valider des modifications de code. Vous pouvez ouvrir n'importe quel dépôt, fork ou pull request dans l'éditeur.
VS Code for the Web est disponible gratuitement pour tout le monde sur GitHub.com.
VS Code for the Web offre de nombreux avantages de Visual Studio Code, tels que la recherche, la mise en surbrillance de la syntaxe et une vue du contrôle de code source. Vous pouvez également utiliser La synchronisation des paramètres pour partager vos propres VS Code paramètres avec l’éditeur. Consultez La synchronisation des paramètres dans la VS Code documentation.
VS Code for the Web s’exécute entièrement dans le bac à sable de votre navigateur. L’éditeur ne clone pas le référentiel, mais utilise plutôt l’extension GitHub Référentiels pour effectuer la plupart des fonctionnalités que vous utiliserez. Votre travail est enregistré dans le stockage local du navigateur jusqu’à ce que vous le validiez. Vous devez valider régulièrement vos modifications pour vous assurer qu’elles soient toujours accessibles.
Vous devez être connecté à GitHub pour utiliser VS Code for the Web.
Ouverture de VS Code for the Web depuis GitHub
Vous pouvez ouvrir n’importe quel GitHub dépôt VS Code for the Web de l’une des manières suivantes :
-
Pour ouvrir le dépôt dans le même onglet de navigateur, appuyez sur . en parcourant n’importe quel dépôt ou pull request sur GitHub.
Pour ouvrir le dépôt dans un nouvel onglet de navigateur, appuyez sur >.
-
Modifiez l’URL de « github.com » en « github.dev ».
-
Lorsque vous affichez un fichier, sélectionnez le menu déroulant, puis cliquez sur github.dev.
Codespaces et VS Code for the Web
Les deux VS Code for the Web et GitHub Codespaces vous permettent de modifier votre code directement à partir de votre dépôt. Toutefois, ils offrent des avantages légèrement différents, selon votre cas d’usage.
| VS Code for the Web | GitHub Codespaces | |
|---|---|---|
| Coût | Libre. | Quota mensuel gratuit d'utilisation pour les comptes personnels. Consultez facturation des Codespaces GitHub. |
| Disponibilité | Disponible pour tout le monde sur GitHub.com. | Disponible pour tout le monde sur GitHub.com. |
| Démarrage | VS Code for the Web s’ouvre instantanément avec une touche et vous pouvez commencer à l’utiliser immédiatement, sans avoir à attendre une configuration ou une installation supplémentaire. | Lorsque vous créez ou reprenez un codespace, une machine virtuelle est affectée à celui-ci, et le conteneur est configuré en fonction du contenu d’un fichier devcontainer.json. Cette configuration peut prendre quelques minutes pour créer l’environnement. Consultez « Création d’un codespace pour un dépôt ». |
| Calculer | Il n’existe aucun calcul associé. Vous ne pourrez donc pas générer et exécuter votre code ou utiliser un terminal intégré. | Avec GitHub Codespaces, vous obtenez la puissance d’une machine virtuelle dédiée sur laquelle vous pouvez exécuter et déboguer votre application, et vous pouvez utiliser le terminal exactement comme vous le feriez dans votre environnement local. |
| Extensions | Seul un sous-ensemble d’extensions pouvant s’exécuter sur le web s’affiche dans la vue Extensions et peut être installé. Consultez Utilisation des extensions. | Avec GitHub Codespaces, vous pouvez utiliser la plupart des extensions à partir du Visual Studio Code Marketplace. |
Utilisation du contrôle de code source
Lorsque vous utilisez VS Code for the Web, toutes les actions sont gérées via la vue « Contrôle de code source », qui se trouve dans la barre d’activité sur le côté gauche. Pour plus d’informations sur la vue « Contrôle de code source », consultez Contrôle de version dans la VS Code documentation.
Comme VS Code for the Web utilise l’extension GitHub Repositories pour assurer son fonctionnement, vous pouvez changer de branche sans avoir à mettre les modifications de côté. Consultez GitHub référentiels dans la VS Code documentation.
Créer une branche
-
Si la branche actuelle n’est pas affichée dans la barre d’état, au bas de votre codespace, cliquez avec le bouton droit sur la barre d’état, puis sélectionnez Contrôle de code source.
-
Cliquez sur le nom de la branche dans la barre d’état.
-
Dans la liste déroulante, cliquez sur la branche vers laquelle vous souhaitez basculer ou entrez le nom d’une nouvelle branche, puis cliquez sur Créer une branche.
Validation de vos modifications
-
Dans la barre d’activités, cliquez sur l'onglet Contrôle de code source.
-
Pour mettre vos modifications en attente, cliquez sur à côté du fichier que vous avez modifié, ou à côté de modifications si vous avez modifié plusieurs fichiers et que vous souhaitez tous les mettre en attente.
-
Dans la zone de texte, tapez un message de validation décrivant le changement effectué.
-
Cliquez sur Valider et envoyer.
Vos modifications sont automatiquement envoyées à votre branche sur GitHub.
Créer une demande de pull
-
Une fois que vous avez validé les modifications apportées à votre copie locale du référentiel, cliquez sur l’icône de demande de tirage en haut de la barre latérale « Contrôle de code source ».
-
Vérifiez que la branche locale, le dépôt à partir duquel vous effectuez la fusion, ainsi que la branche distante et le dépôt distant vers lesquels vous effectuez la fusion sont corrects. Donnez ensuite un titre et une description à la demande de tirage.
-
Cliquez sur Créer.
Utilisation d'une pull request existante
Vous pouvez utiliser VS Code for the Web pour travailler sur une pull request existante.
- Accédez à la pull request que vous souhaitez ouvrir dans VS Code for the Web.
- Appuyez sur
.pour ouvrir la pull request dans VS Code for the Web. - Une fois que vous avez apporté des modifications, validez-les en suivant les étapes décrites dans Valider vos modifications. Vos modifications étant validées directement dans la branche, il n’est pas nécessaire de les envoyer (push).
Utilisation d’extensions
VS Code for the Web prend en charge les VS Code extensions qui ont été spécifiquement créées ou mises à jour pour s’exécuter sur le web. Ces extensions sont appelées « extensions web ». Pour savoir comment créer une extension web ou mettre à jour votre extension existante pour fonctionner pour le web, consultez les extensions web dans la VS Code documentation.
Les extensions qui peuvent s’exécuter dans VS Code for the Web apparaîtront dans la vue des extensions et pourront être installées. Si vous utilisez la Synchronisation des paramètres, toutes les extensions compatibles sont également installées automatiquement. Pour plus d’informations, consultez La synchronisation des paramètres dans la VS Code documentation.