utilisez Live Share pour collaborer dans Visual Studio Code

vous êtes prêt à commencer à collaborer avec Live Share dans Visual Studio Code ? dans cet article, nous allons vous guider tout au long de la configuration d’une session de collaboration dans Visual Studio Code à l’aide de l’Extension Live Share.

Notez que les activités de collaboration décrites ici impliquent un hôte de session de collaboration unique et un ou plusieurs invités. L’hôte est la personne qui a démarré la session de collaboration et toute personne qui rejoint est un invité.

Vous recherchez un résumé abrégé ? Consultez les Démarrages rapides de partage ou de jointure .

Conseil

Saviez-vous que vous pouvez rejoindre votre propre session de collaboration ? cela vous permet d’essayer Live Share vous-même ou de lancer une instance de Visual Studio ou Visual Studio Code et de vous y connecter à distance. Vous pouvez même utiliser la même identité sur les deux instances. À tester dès maintenant !

Configuration requise

avant de commencer, vous aurez besoin d’une version prise en charge de Visual Studio Code pour les exigences Live Share core.

Visual Studio Code (1.22.0 ou version ultérieure) doit s’exécuter sur l’un des systèmes d’exploitation suivants :

  • Windows: 7, 8,1 ou 10.

  • MacOS: Sierra (10,12) et versions ultérieures. En raison de la Configuration requise de .net Core 2,0, El Capitan (10,11) et les versions antérieures ne sont actuellement pas pris en charge.

  • Linux: 64-bit Ubuntu Desktop 16,04 et versions ultérieures, Fedora Workstation 27 et versions ultérieures, ou CentOS 7.

installer le Pack d’Extension Live Share

lorsque vous téléchargez et utilisez Visual Studio Live Share, vous acceptez les termes du contrat de licence et la déclaration de confidentialité. Si vous rencontrez des problèmes, consultez la section dépannage.

  1. Installez Visual Studio Code.
  2. téléchargez et installez le Pack d’Extension Visual Studio Live Share à partir de Marketplace.
  3. Rechargement Visual Studio Code.
  4. Attendez que les dépendances soient téléchargées et installées. (Voir la barre d’État.)
    Capture d’écran montrant la barre d’État pendant le téléchargement.
  5. Linux uniquement: si une notification s’affiche sur l’installation des bibliothèques manquantes :
    1. Sélectionnez installer dans la notification.
    2. Entrez votre mot de passe d’administrateur (sudo) lorsque vous y êtes invité.
    3. redémarrez Visual Studio Code lorsque l’installation est terminée.

Bouton pour télécharger Live Share.

Étapes d’installation de Linux

Linux est un environnement hautement variable. étant donné le nombre d’environnements de postes de travail et de distributions, la mise en Live Share installée peut être compliquée. si vous utilisez des versions prises en charge d’Ubuntu Desktop (16.04 +), Fedora Workstation (27 +) ou CentOS 7 et que vous utilisez uniquement des distributions officielles de Visual Studio Code, le processus doit être simple. Si vous utilisez une configuration non standard ou une distribution en aval, vous risquez de rencontrer des complications. Pour plus d’informations, consultez Détails de l’installation de Linux.

Installer les composants requis pour Linux

certaines des distributions de Linux manquent de bibliothèques qui Live Share besoins. par défaut, Live Share tente de détecter et d’installer les composants requis de Linux. vous verrez une notification vous invitant à installer des bibliothèques lorsque Live Share rencontre un problème qui peut être dû à des bibliothèques manquantes :

Capture d’écran de la notification pour les bibliothèques Linux manquantes.

Lorsque vous sélectionnez installer, une fenêtre de terminal s’ouvre. Entrez votre mot de passe d’administrateur (sudo) pour continuer. Si l’installation se termine correctement, redémarrez Visual Studio Code. Vous devez tous les définir. vous pouvez également consulter Astuces par distribution pour d’autres conseils et solutions de contournement.

si vous voyez un message indiquant que le script ne prend pas en charge votre distribution, consultez Astuces pour obtenir des distributions prises en charge par la communauté pour plus d’informations que la communauté a partagées avec nous.

si vous ne souhaitez pas Visual Studio Code exécuter la commande pour vous, vous pouvez également réexécuter la dernière version de ce script à tout moment en exécutant cette commande à partir d’une fenêtre de terminal :

wget -O ~/vsls-reqs https://aka.ms/vsls-linux-prereq-script && chmod +x ~/vsls-reqs && ~/vsls-reqs

Intégration du navigateur Linux

Visual Studio Live Share ne nécessite généralement pas d’étapes d’installation supplémentaires pour permettre l’intégration du navigateur sur Linux.

Sur certaines distributions rares, vous pouvez être averti que votre mot de passe d’administrateur (sudo) est requis pour terminer l’installation. Une fenêtre de terminal indiquant où le lanceur de navigateur sera installé s’affiche. Entrez votre mot de passe lorsque vous y êtes invité, puis sélectionnez entrée lorsque l’installation est terminée pour fermer la fenêtre de terminal.

pour plus d’informations sur la raison pour laquelle le mot de passe est requis et sur l’emplacement de Live Share place les fichiers, consultez intégration du navigateur Linux. Si vous ne pouvez pas faire fonctionner l’intégration du navigateur, vous pouvez toujours joindre les sessions de collaboration manuellement.

Connectez-vous à Live Share

pour collaborer, vous devez vous connecter à Visual Studio Live Share afin que tout le monde sache qui vous êtes. Il s’agit d’une mesure de sécurité qui ne vous permet pas d’effectuer des activités de marketing ou d’autres activités de recherche. vous pouvez vous connecter à l’aide d’un compte personnel microsoft (par exemple, @outlook.com ), d’un compte professionnel ou scolaire microsoft (Azure Active Directory) ou d’un compte GitHub. Il est facile de se connecter.

sélectionnez Live Share dans la barre d’état ou appuyez sur Ctrl + maj + p ou Cmd + maj + P , puis sélectionnez Live Share : se connecter avec le navigateur.

capture d’écran montrant le bouton de connexion Visual Studio Code.

Une notification vous invite à vous connecter à l’aide de votre navigateur Web. Lorsque vous sélectionnez lancer la connexion, un navigateur s’ouvre pour vous permettre de terminer le processus de connexion. Fermez simplement le navigateur lorsque vous avez terminé.

Capture d’écran montrant la confirmation de la connexion d’un navigateur Web.

Notes

utilisateurs Linux : vous pouvez être invité à entrer un code utilisateur si vous utilisez une version antérieure de Live Share (0.3.295 ou version antérieure). Mettez à jour la version la plus récente de l’extension ou, pour afficher le code, sélectionnez rencontrer des problèmes ? après vous être connecté. Pour plus d’informations, consultez se connecter à l’aide d’un code utilisateur.

Conseil avancé : Les liveshare.account liveshare.accountProvider paramètres et vous permettent de sélectionner le compte utilisé pour la connexion automatique si vous avez des informations d’identification mises en cache pour plusieurs comptes. Par exemple, imaginez que vous travaillez sur deux projets et que vous souhaitez vous connecter à eux à l’aide de différentes identités. dans les paramètres de votre espace de travail Visual Studio Code, vous pouvez définir liveshare.account une autre adresse de messagerie dans chaque répertoire de projet. Les projets se connectent alors automatiquement avec le compte approprié. Vous pouvez définir le liveshare.accountProvider paramètre sur "microsoft" ou, "github" si vous utilisez la même adresse de messagerie avec plusieurs fournisseurs.

si Visual Studio Code ne sélectionne pas votre connexion une fois que vous avez terminé le processus de connexion dans le navigateur, consultez se connecter à l’aide d’un Code utilisateur. Ou consultez la résolution des problèmes pour obtenir d’autres conseils.

Se connecter à l’aide d’un code utilisateur

si Visual Studio Code ne sélectionne pas une connexion terminée, vous pouvez entrer un Code utilisateur à la place.

  1. sélectionnez Ctrl + maj + p ou Cmd + maj + P , puis exécutez la commande Live Share : se connecter avec le code utilisateur .

  2. Un navigateur doit s’ouvrir. Utilisez-le pour terminer le processus de connexion :

    Notes

    Si un navigateur ne s’ouvre pas automatiquement, accédez à https://insiders.liveshare.vsengsaas.visualstudio.com/auth/login et connectez-vous.

  3. Une fois que vous avez terminé, sélectionnez problèmes ? Cliquez ici pour accéder au code utilisateur pour voir le code utilisateur.

    Capture d’écran montrant un code utilisateur dans une fenêtre de navigateur.

  4. Copiez le code utilisateur.

  5. Collez le code utilisateur dans le champ d’entrée qui apparaissait lors de l’exécution de la commande. Sélectionnez entrée pour terminer le processus de connexion.

    Capture d’écran montrant la zone de saisie du code utilisateur.

rechercher des commandes Live Share

dans le Live Share viewlet

une fois que vous avez installé Visual Studio Live Share, un onglet personnalisé s’affiche dans la barre d’activité Visual Studio Code. dans cet onglet, vous pouvez accéder à toutes les fonctions de Live Share pour collaborer. Lorsque vous partagez ou joignez une session de collaboration, une vue s’affiche également sous l’onglet Explorateur , qui vous permet d’accéder à ces fonctions.

Screenshot that shows the Live Share tab in Visual Studio Code. Screenshot that shows the Explorer tab in Visual Studio Code.

À l’aide de ces vues, vous pouvez voir l’emplacement d’un participant dans le code partagé, sélectionner les participants à suivre, cibler les participants, accéder aux serveurs partagés et aux terminaux, et bien plus encore.

Dans le menu de commande étendu

toutes les fonctions de Visual Studio Live Share sont également disponibles à partir de la Palette de commandes Visual Studio Code. Vous pouvez accéder à la palette de commandes en sélectionnant Ctrl + Maj + p / cmd + Maj + P ou F1. Vous trouverez une liste complète des commandes en entrant Live share.

Étant donné que cette liste peut être longue, il peut être plus facile d’utiliser un menu de commande étendu à partir de la barre d’État. Si vous sélectionnez le bouton se connecter/état de session dans la barre d’État, une liste contextuelle des commandes pouvant être utilisées s’affiche :

capture d’écran montrant le bouton d’état de session Visual Studio Code.

Démarrer et arrêter une session

après avoir téléchargé et installé Visual Studio Live Share, procédez comme suit pour démarrer une session de collaboration et inviter un collègue à travailler avec vous.

  1. Connexion

    après l’installation de l’Extension de Live Share, le rechargement et l’attente de l’installation des dépendances, connectez-vous pour permettre aux autres collaborateurs de savoir qui vous êtes. Pour plus d’informations, consultez se connecter.

  2. Ouvrir un dossier

    Utilisez votre flux de travail normal pour ouvrir un dossier, un projet ou une solution que vous souhaitez partager avec vos invités.

  3. [Facultatif] Mettre à jour des fichiers masqués ou exclus

    par défaut, Live Share masque sur vos invités tous les fichiers et dossiers référencés dans les fichiers. gitignore de vos dossiers partagés. Masquer un fichier l’empêche d’apparaître dans l’arborescence des fichiers de l’invité. L' exclusion d’un fichier applique une règle plus stricte. l’exclusion d’un fichier empêche Live Share de l’ouvrir pour un invité dans des situations telles que atteindre la définition ou si vous exécutez pas à pas un fichier pendant le débogage ou que vous êtes « suivi ». Pour masquer ou exclure des fichiers, ajoutez un .vsls.jssur le fichier avec les paramètres appropriés à votre projet. Pour plus d’informations, consultez contrôle de l’accès aux fichiers et visibilité.

  4. Lancer une session de collaboration

    pour démarrer une session, sélectionnez Live Share dans la barre d’état ou sélectionnez Ctrl + maj + p ou Cmd + maj + p , puis sélectionnez Live Share : démarrer une session de collaboration (partage).

    capture d’écran montrant le bouton Live Share.

    Notes

    la première fois que vous partagez, votre logiciel de pare-feu de bureau peut vous inviter à autoriser l’agent de Live Share à ouvrir un port. L’ouverture d’un port est facultative. Il permet à un mode direct sécurisé d’améliorer les performances lorsque la personne avec laquelle vous travaillez se trouve sur le même réseau que vous. Pour plus d’informations, consultez modification du mode de connexion.

    Un lien d’invitation sera automatiquement copié dans le presse-papiers. Lorsqu’il est ouvert dans un navigateur, le lien permet à d’autres utilisateurs de rejoindre une nouvelle session de collaboration qui partage le contenu des dossiers.

    vous verrez également la modification de l’élément de barre d’état Live Share pour représenter l’état de session. Pour voir à quoi elle ressemble, consultez les informations sur l' État de session plus loin dans cet article.

    Si vous avez besoin de récupérer le lien d’invitation une fois que vous avez commencé à partager, vous pouvez l’utiliser en sélectionnant l’élément de la barre d’état de l’état de session, puis en sélectionnant inviter d’autres personnes (copier le lien).

  5. [Facultatif] Activer le mode lecture seule

    Une fois que vous avez démarré votre session de collaboration, vous pouvez définir la session en lecture seule pour empêcher les invités d’apporter des modifications au code que vous partagez.

    Une fois que vous avez partagé, vous recevez une notification indiquant que le lien d’invitation est copié dans le presse-papiers. Vous pouvez ensuite sélectionner l’option pour que la session soit en lecture seule :

    Capture d’écran montrant le bouton créer en lecture seule.

  6. Envoyer le lien

    envoyez le lien par courrier électronique, marge, Skype ou d’autres plateformes aux invités que vous souhaitez inviter. étant donné le niveau d’accès que les sessions de Live Share peuvent fournir aux invités, vous devez uniquement partager avec les personnes auxquelles vous faites confiance et vous devez réfléchir aux implications de ce que vous partagez.

    Astuce de sécurité : vous souhaitez comprendre les implications en matière de sécurité de certaines fonctionnalités de Live Share ? Consultez l’article Sécurité.

    Les invités que vous invitez peuvent poser des questions. L’article démarrage rapide : joindre votre première session fournit des informations sur la prise en main en tant qu’invité.

  7. [Facultatif] Approuver l’invité

    Par défaut, les invités rejoignent automatiquement la session de collaboration ; lorsqu’ils sont prêts à travailler avec vous, vous recevez une notification. Cette notification vous donne la possibilité de les supprimer de la session. Vous pouvez également choisir d’exiger une approbation explicite pour toute personne qui rejoint.

    Pour activer cette approbation, ajoutez le code suivant à settings.jssur :

    "liveshare.guestApprovalRequired": true
    

    Quand ce paramètre est activé, une notification vous invite à approuver les invités avant qu’ils ne puissent rejoindre :

    capture d’écran montrant une demande d’approbation de jointure Visual Studio Code.

    Pour plus d’informations sur les considérations sur la sécurité des invitations , consultez invitations et accès à la participation.

Et voilà !

Arrêter la session de collaboration

En tant qu’ordinateur hôte, vous pouvez arrêter le partage complet et mettre fin à la session de collaboration à tout moment. pour ce faire, ouvrez la vue Live Share sous l’onglet explorateur ou l’onglet VS Live Share et sélectionnez le bouton arrêter la session de collaboration :

Capture d’écran montrant le bouton arrêter la session de collaboration.

Tous les invités seront avertis que la session est terminée. Une fois la session terminée, les invités ne peuvent pas accéder au contenu. Tous les fichiers temporaires sont automatiquement nettoyés.

Vous rencontrez des problèmes de partage ? Consultez l’article sur la résolution des problèmes .

Joindre et fermer une session

après avoir téléchargé et installé Visual Studio Live Share, les invités ne doivent prendre que quelques étapes pour rejoindre une session de collaboration hébergée. Il existe deux façons de joindre : via un navigateur et manuellement.

Astuce de sécurité : Les invités qui adhèrent à une session de collaboration doivent comprendre que les hôtes peuvent limiter leur accès à certains fichiers ou fonctionnalités. vous souhaitez comprendre les implications en matière de sécurité des fonctionnalités et des paramètres de Live Share ? Consultez l’article Sécurité.

Joindre via un navigateur

Le moyen le plus simple de rejoindre une session de collaboration consiste simplement à ouvrir le lien d’invitation dans un navigateur Web. Voici ce à quoi vous pouvez vous attendre :

  1. Connexion

    après l’installation de l’Extension de Live Share, le rechargement et l’attente de l’installation des dépendances, connectez-vous pour permettre aux autres collaborateurs de savoir qui vous êtes. Pour plus d’informations, consultez se connecter.

  2. Sélectionnez le lien d’invitation/Ouvrez l’invitation dans votre navigateur

    Ouvrez (ou rouvrez) le lien d’invitation dans un navigateur.

    Notes

    si vous n’avez pas installé l’Extension de Live Share, vous obtiendrez des liens vers la place de marché. Installez l’extension, redémarrez l’outil choisi, puis réessayez.

    Vous devez être informé que le navigateur souhaite démarrer un outil qui est activé pour Live Share. Si vous laissez l’outil démarrer l’outil, vous serez connecté à la session de collaboration au démarrage.

    Capture d’écran montrant la page de jointure dans un navigateur.

    Si l’ordinateur hôte est hors connexion, vous en êtes informé. Vous pourrez alors le contacter et lui demander de relancer le partage.

    Notes

    assurez-vous d’avoir démarré l’outil au moins une fois après avoir installé l’Extension de Visual Studio Live Share et autorisé à terminer l’installation avant d’ouvrir/rouvrir la page d’invitation. Si le problème persiste, Consultez joindre manuellement.

  3. Collaborer

    Et voilà ! Au moment où vous serez connecté, vous pourrez commencer à collaborer.

    vous verrez le bouton Live Share changer pour indiquer un état de session. Consultez les informations sur l' État de session plus loin dans cet article.

    Une fois la jointure terminée, vous accédez automatiquement au fichier que l’hôte est en train de modifier.

Accès manuel

Vous pouvez également joindre manuellement sans utiliser de navigateur Web. Cette option peut être utile lorsque l’outil que vous souhaitez utiliser est déjà en cours d’exécution, que vous souhaitez utiliser un outil que vous n’utilisez pas habituellement, ou que vous ne parvenez pas à obtenir des liens d’invitation pour travailler. La procédure est simple :

  1. Connexion

    après l’installation de l’Extension Live Share, le rechargement et l’attente de l’installation des dépendances, connectez-vous pour permettre aux autres collaborateurs de savoir qui vous êtes. Pour plus d’informations, consultez se connecter.

  2. Utiliser la commande d’accès

    sous l’onglet Live Share de la barre d’activité Visual Studio Code, sélectionnez le bouton ou l’élément rejoindre la session de collaboration :

    Capture d’écran montrant le bouton rejoindre une session de collaboration.

  3. Coller le lien d’invitation

    Collez l’URL d’invitation que vous avez envoyée et sélectionnez entrée pour confirmer.

  4. Travaillent!

    Et voilà ! Vous devez bientôt être connecté à la session de collaboration.

    le bouton Live Share change pour communiquer l’état de la session. Pour plus d’informations sur l' État de session , consultez plus loin dans cet article.

    Une fois la jointure terminée, vous accédez automatiquement au fichier que l’hôte est en train de modifier.

Conserver une session de collaboration

en tant qu’invité, vous pouvez quitter une session de collaboration sans la terminer pour d’autres en fermant simplement la fenêtre de Visual Studio Code. si vous souhaitez que la fenêtre reste ouverte, vous pouvez ouvrir l’onglet explorateur de Live Share ou l’onglet VS Live Share et sélectionner le bouton laisser la session de collaboration :

Capture d’écran montrant le bouton Leave session collaboration.

Tous les fichiers temporaires sont automatiquement nettoyés, de sorte que vous n’avez rien d’autre à faire.

Vous rencontrez des problèmes de jointure ? Consultez la résolution des problèmes.

Coédition

Notes

La co-édition a des limitations dans certaines langues. Pour plus d’informations sur les fonctionnalités spécifiques à une langue, consultez prise en charge des plateformes .

Lorsqu’un invité rejoint une session de collaboration, tous les collaborateurs peuvent voir immédiatement les modifications et les sélections des autres en temps réel. Il vous suffit de choisir un fichier dans l’Explorateur de fichiers et de l’éditer. Les hôtes et les invités voient les modifications à mesure que vous les apportez et peuvent contribuer eux-mêmes, ce qui facilite l’itération et la résolution rapide des problèmes.

Capture d’écran montrant une session de co-édition.

Notes

Les invités qui rejoignent une session de collaboration en lecture seule ne peuvent pas apporter de modifications à des fichiers. Les hôtes peuvent activer le mode lecture seule lorsqu’ils partagent une session. En tant qu’invité, vous pouvez déterminer si vous avez rejoint une session en lecture seule en examinant l’état de la session.

Les participants peuvent voir les curseurs et les modifications. Ils peuvent également voir les sélections que vous effectuez. Cela facilite la mise en évidence de l’endroit où des problèmes peuvent exister ou pour communiquer des idées.

Capture d’écran montrant le code sélectionné.

Vous et d’autres participants pouvez accéder à n’importe quel fichier du projet partagé. Vous pouvez modifier ensemble ou indépendamment, de sorte que vous pouvez passer d’une investigation à une autre pour apporter des modifications mineures à la modification collaborative complète.

Les modifications qui en résultent sont conservées sur l’ordinateur hôte lorsqu’elles sont enregistrées. Il n’est donc pas nécessaire de synchroniser, transmettre ou envoyer des fichiers lorsque vous avez terminé la modification.

Astuce de sécurité : Étant donné que tous les participants peuvent accéder de façon indépendante aux fichiers et les modifier, en tant qu’ordinateur hôte, vous souhaiterez peut-être limiter les fichiers auxquels les invités peuvent accéder dans votre projet via un fichier .vsls.js. En tant qu’invité, vous devez vous rendre compte que certains fichiers ne s’affichent pas à la suite de ces paramètres. Pour plus d’informations, consultez contrôle de l’accès aux fichiers et visibilité.

Modifier le comportement de l’indicateur de participant

par défaut, Visual Studio Live Share affiche automatiquement un indicateur en regard du curseur d’un participant au pointage ou lorsque le participant apporte des modifications, met en surbrillance un texte ou déplace le curseur. Dans certains cas, vous souhaiterez peut-être modifier ce comportement.

pour modifier le comportement, ouvrez settings.jssur (fichiers > préférences > Paramètres), ajoutez l’une des lignes suivantes, puis redémarrez Visual Studio Code.

Paramètre Comportement
"liveshare.nameTagVisibility":"Never" L’indicateur n’est visible que lorsque vous pointez sur le curseur.
"liveshare.nameTagVisibility":"Activity" Il s’agit de la valeur par défaut. L’indicateur est visible au pointage ou si le participant modifie, met en surbrillance ou déplace le curseur.
"liveshare.nameTagVisibility":"Always" L’indicateur est toujours visible.

Rechercher et répertorier les participants

pour voir rapidement qui est dans la session de collaboration, consultez la liste des participants sous l’onglet explorateur de Live Share ou sous l’onglet VS Live Share :

Capture d’écran montrant les participants d’une session.

Pour suivre un participant de cette liste dans votre groupe éditeur actif, sélectionnez le participant.

vous pouvez également sélectionner Ctrl + maj + p ou Cmd + maj + P , puis sélectionner Live Share : répertorier les participants ou sélectionner l’élément de barre d’état qui indique le nombre de participants dans votre session :

Capture d’écran qui affiche l’élément de barre d’État.

Une liste de tous les participants de la session s’affiche. Le comportement ici diffère de celui du bouton en punaise. Cette liste s’affiche même s’il n’y a qu’une seule personne dans la session avec vous, afin que vous puissiez toujours voir rapidement où se trouve une autre personne. Comme avec le bouton en forme de punaise, vous pouvez sélectionner des participants dans la liste pour les suivre. Sélectionnez Échap si vous souhaitez quitter à la place.

Suivre avec un collaborateur

Il est parfois nécessaire d’expliquer un problème ou une conception qui s’étend sur plusieurs fichiers ou emplacements dans le code. Dans ces situations, il peut être utile de suivre temporairement vos collègues lorsqu’ils se déplacent dans un projet. Pour cette raison, lorsque vous rejoignez une session de collaboration, vous suivez automatiquement l’hôte. Lorsque vous suivez une personne, votre éditeur reste synchronisé avec la position de défilement et le fichier actuellement ouverts de cette personne.

Notes

par défaut, Live Share partage des fichiers ouverts qui se trouvent en dehors du dossier partagé. Si vous souhaitez modifier ce comportement, remplacez par liveshare.shareExternalFiles false dans settings.js.

Focus de la demande

Vous pouvez parfois souhaiter que tout le monde d’une session de collaboration examine une chose que vous êtes en train de faire. Live Share vous permet de demander à ce que tout le monde se focalise sur vous avec une notification qui lui permette de vous suivre facilement.

ouvrez l’onglet VS Live Share dans la barre d’activité Visual Studio Code ou l’onglet explorateur de Live Share, puis sélectionnez le bouton concentrer les participants :

Capture d’écran montrant le bouton des participants au focus.

Tout le monde de la session de collaboration recevra une notification indiquant que vous avez demandé son attention :

Capture d’écran montrant la notification de focus de la demande.

Ils peuvent ensuite sélectionner suivre dans la notification lorsqu’ils sont prêts à se concentrer sur vos actions.

Démarrer et arrêter après les collaborateurs

pour commencer à suivre un participant (comme un hôte ou un invité), sélectionnez le nom du participant dans la liste des participants sous l’onglet explorateur de Live Share ou sous l’onglet VS Live Share . Le cercle en regard du nom devient plein pour indiquer que vous les suivez :

Capture d’écran montrant un participant qui est suivi.

Vous pouvez également sélectionner le bouton Punaise dans le coin supérieur droit du groupe de l’éditeur ou sélectionner Ctrl + Alt + f ou Cmd + Alt + f.

Capture d’écran montrant le bouton Punaise.

Notes

Si plusieurs personnes se trouvent dans la session de collaboration, vous êtes invité à sélectionner le participant que vous souhaitez suivre :

Capture d’écran montrant une liste de participants.

Étant donné que les éléments suivants sont liés à un groupe d’éditeurs, vous pouvez utiliser le mode fractionné ou la disposition grille pour créer un groupe qui suit un participant et un groupe qui ne l’est pas. Cette disposition vous permet de suivre passivement une personne tout en travaillant sur un travail de façon indépendante. Quand vous avez sélectionné un groupe d’éditeurs, vous pouvez sélectionner un participant dans la liste des participants pour que le groupe suive le participant.

Capture d’écran montrant deux groupes d’éditeurs en mode fractionné.

Pour faciliter le basculement en mode suivi et l’édition par vous-même, vous arrêtez automatiquement le suivi de l’une des actions suivantes :

  • Vous commencez à modifier le fichier actuellement actif.
  • Vous ouvrez un fichier différent.
  • Vous fermez le fichier actif.

En outre, vous pouvez arrêter explicitement le suivi d’une personne en sélectionnant à nouveau le bouton Punaise ou en sélectionnant Ctrl + Alt + f ou Cmd + Alt + f.

Codébogage

le Visual Studio Live Share fonctionnalité de débogage collaboratif est un moyen puissant de déboguer un problème. Il offre une expérience collaborative pour résoudre les problèmes. Il permet également à vos participants et à vous-même d’examiner les problèmes qui peuvent être spécifiques à l’environnement en fournissant une session de débogage partagée sur l’ordinateur de l’hôte.

Astuce de sécurité : Étant donné que les participants peuvent accéder indépendamment aux fichiers et les modifier, en tant qu’ordinateur hôte, vous souhaiterez peut-être limiter les fichiers auxquels les invités peuvent accéder dans votre projet via un fichier .vsls.js. Vous devez également savoir que l’accès à la console/REPL permet aux participants d’exécuter des commandes sur votre ordinateur. vous devez donc uniquement déboguer les personnes avec lesquelles vous faites confiance. Les invités doivent se rendre compte que, en raison des paramètres restrictifs, ils peuvent ne pas être en mesure de suivre le débogueur dans certains fichiers restreints. Pour plus d’informations, consultez contrôle de l’accès aux fichiers et visibilité.

L’utilisation du débogage collaboratif est simple.

  1. Assurez-vous que l’extension de débogage appropriée est installée sur l’hôte et tous les invités. (L’installation n’est pas toujours nécessaire, mais elle est généralement une bonne idée.)

  2. l’hôte, s’il n’est pas déjà configuré pour le projet, doit configurer launch.jssur pour déboguer l’application à partir de Visual Studio Code normalement. Aucune configuration spéciale n’est requise.

  3. L’hôte peut démarrer le débogage à l’aide du bouton sous l’onglet Déboguer, comme d’habitude :

    capture d’écran montrant le bouton de débogage Visual Studio Code.

    Conseil

    vous pouvez également participer à des sessions de débogage Visual Studio à partir de Visual Studio Code, et vice versa. pour plus d’informations, consultez les instructions Visual Studio pour le co-débogage.

Quand le débogueur s’attache côté hôte, tous les invités sont également automatiquement attachés. Une session de débogage est en cours d’exécution sur l’ordinateur de l’hôte, mais tous les participants sont connectés à celui-ci et disposent de leur propre vue :

capture d’écran montrant le débogueur Visual Studio Code.

Tout le monde peut parcourir le processus de débogage, ce qui vous permet de basculer entre les collaborateurs sans avoir à négocier le contrôle.

Notes

Pour plus d’informations sur la prise en charge des fonctionnalités de débogage par langage ou plateforme, consultez prise en charge des plateformes .

Chaque collaborateur peut examiner des variables, accéder à différents fichiers dans la pile des appels, inspecter des variables et même ajouter ou supprimer des points d’arrêt. Les fonctionnalités de co-édition permettent à chaque participant d’effectuer le suivi de l’emplacement des autres, afin qu’ils puissent basculer entre l’examen simultané des aspects du problème et le débogage collaboratif.

Notes

Dans une session de collaboration en lecture seule, les invités ne peuvent pas effectuer un pas à pas détaillé dans le processus de débogage. Ils peuvent ajouter ou supprimer des points d’arrêt et inspecter des variables.

Animation qui montre le débogage simultané.

changer quand Visual Studio Code joint des sessions de débogage

Par défaut, en tant qu’invité, vous êtes automatiquement attaché aux sessions de débogage lorsqu’elles sont partagées par l’hôte. Ce comportement peut être perturbé.

pour modifier ce comportement, ouvrez settings.jssur (fichiers > préférences > Paramètres), ajoutez l’une des lignes suivantes, puis redémarrez Visual Studio Code :

Paramètre Comportement
"liveshare.joinDebugSessionOption":"Automatic" Valeur par défaut. Les invités rejoignent automatiquement toute session de débogage partagée lancée par l’hôte.
"liveshare.joinDebugSessionOption":"Prompt" En tant qu’invité, vous êtes invité à rejoindre une session de débogage partagée lorsqu’elle est démarrée par l’hôte.
"liveshare.joinDebugSessionOption":"Manual" En tant qu’invité, vous devez joindre manuellement des sessions de débogage. Consultez détachement et rattachement.

Détacher et rattacher

En tant qu’invité, vous souhaiterez peut-être arrêter temporairement le débogage. Vous pouvez sélectionner le bouton arrêter dans la barre d’outils déboguer pour détacher le débogueur sans affecter l’hôte ou d’autres invités :

Capture d’écran montrant le bouton arrêter.

Si vous avez mis à jour vos paramètres de façon à ne pas les joindre automatiquement ou si vous souhaitez les rattacher ultérieurement, vous pouvez le faire en sélectionnant Ctrl + Maj + p ou cmd + Maj + P ou en sélectionnant l’élément de la barre d’état d’état de session, puis en sélectionnant attacher à une session de débogage partagée:

Capture d’écran montrant l’attachement à une commande de session de débogage partagé.

Partager l’application en cours d’exécution dans un navigateur

contrairement à Visual Studio, Visual Studio Code ne prend pas en charge les ports d’application web connus pour les types de projets tels que ASP.NET. toutefois, si vous joignez une session de collaboration à partir d’un hôte Visual Studio, vous pouvez voir automatiquement votre navigateur par défaut s’afficher au démarrage du débogage. Le navigateur est ensuite automatiquement connecté aux applications en cours d’exécution de l’hôte. pour plus d’informations, consultez fonctionnalités de Visual Studio.

En tant qu’hôte, vous pouvez obtenir un résultat similaire en partageant manuellement l’application, ou d’autres points de terminaison comme les services RESTful, à l’aide de la fonctionnalité de partage de serveur local. Visual Studio et Visual Studio Code invités peuvent ensuite ouvrir un navigateur sur le même port localhost pour voir l’application en cours d’exécution. Pour plus d’informations, consultez partager un serveur.

Partager des serveurs ou des terminaux

Partage de serveur

De temps à autre, les hôtes de session de collaboration peuvent souhaiter partager une application Web ou d’autres serveurs ou services exécutés localement avec des invités. Cela peut aller d’autres points de terminaison RESTful aux bases de données et à d’autres serveurs. Visual Studio Live Share offre la possibilité de spécifier un numéro de port local, de lui donner un nom (facultatif), puis de le partager avec tous les invités.

Les invités pourront alors accéder au serveur que vous avez partagé sur ce port à partir de leurs propres ordinateurs locaux sur le même port. Par exemple, si vous partagez un serveur Web qui s’exécute sur le port 3000, les invités peuvent accéder au même serveur Web exécutant sur leurs propres ordinateurs à l’adresse http://localhost:3000 .

Cette connexion s’effectue via un tunnel SSL ou SSH de sécurité amélioré entre l’hôte et les invités et authentifié par le biais du service. Ce mécanisme de connexion permet de s’assurer que seules les personnes de la session de collaboration ont accès.

Astuce de sécurité : En tant qu’ordinateur hôte, soyez sélectif sur les ports que vous partagez avec les invités. Conservez les ports d’application (plutôt que de partager un port système). Pour les invités, les ports partagés se comportent exactement comme s’ils étaient en cours d’exécution sur l’ordinateur de l’invité. Ce comportement est utile, mais il peut être risqué si vous partagez le mauvais port.

Pour des raisons de sécurité, seuls les serveurs s’exécutant sur les ports que vous spécifiez sont disponibles pour d’autres invités. Il est facile pour l’hôte de session de collaboration d’en ajouter un. Voici comment procéder :

  1. sous l’onglet VS Live Share ou l’onglet explorateur de Live Share, sélectionnez le bouton ou l’élément de serveur de partage :

    Capture d’écran montrant le bouton de partage du serveur.

  2. Entrez le numéro du port sur lequel le serveur est en cours d’exécution. Si vous le souhaitez, entrez un nom :

    Capture d’écran montrant l’invite de numéro de port.

Et voilà ! Le serveur sur le port que vous avez spécifié est maintenant mappé à l’hôte local de chaque invité sur le même port (sauf si ce port est déjà utilisé).

Si le port est déjà utilisé sur l’ordinateur de l’invité, un autre port est automatiquement sélectionné. en tant qu’invité, vous pouvez afficher la liste des ports partagés (par leur nom, s’ils sont spécifiés) sous l’onglet explorateur de Live Share ou l’onglet VS Live Share . La liste se trouve sous serveurs partagés. Si vous sélectionnez un port, ce serveur s’ouvre dans votre navigateur. Vous pouvez également cliquer avec le bouton droit et sélectionner une option pour copier le lien du serveur vers le presse-papiers.

Capture d’écran montrant la liste des serveurs partagés.

Pour des raisons de sécurité, les invités ne peuvent pas contrôler quels ports sur l’ordinateur hôte sont partagés.

Pour arrêter le partage d’un serveur local, l’ordinateur hôte peut pointer sur l’élément de serveur dans la liste serveurs partagés , puis sélectionner le bouton Annuler le partage du serveur :

Capture d’écran montrant le bouton Annuler le partage du serveur.

Partage terminal

Les développeurs modernes utilisent fréquemment un large éventail d’outils en ligne de commande. Live Share permet aux hôtes de partager un terminal avec des invités. Le terminal partagé peut être en lecture seule ou entièrement collaboratif, de sorte que vous et les invités pouvez exécuter des commandes et consulter les résultats. Vous pouvez rendre la sortie du terminal visible pour les invités. Vous pouvez également les autoriser à exécuter des tests ou des builds, voire à trier des problèmes spécifiques à l’environnement qui se produisent uniquement sur votre ordinateur.

Par défaut, les terminaux ne sont pas partagés, car ils donnent aux invités au moins un accès en lecture seule à la sortie des commandes que vous exécutez (si vous n’avez pas la possibilité d’exécuter des commandes elles-mêmes). Cette configuration par défaut vous permet d’exécuter des commandes dans des terminaux locaux avec un risque et un partage réduits uniquement lorsque vous en avez besoin. Et seuls les hôtes peuvent démarrer des terminaux partagés. Cette limitation empêche les invités de démarrer un et d’effectuer une tâche que vous n’attendez pas.

en tant qu’ordinateur hôte, vous pouvez partager un terminal à partir du VS Live Share ou de l’onglet explorateur de Live Share. Sélectionnez le bouton ou l’élément de terminal de partage :

Capture d’écran montrant le bouton de partage de terminal.

À ce stade, vous pouvez choisir de rendre le terminal accessible en lecture seule ou en lecture/écriture. Quand le terminal est en lecture/écriture, tout le monde peut taper le terminal, y compris l’ordinateur hôte. Ainsi, en tant qu’hôte, vous pouvez facilement intervenir si un invité fait un problème que vous n’aimez pas.

Pour être sûr, vous devez accorder un accès en lecture/écriture aux invités uniquement lorsque vous savez qu’ils en ont réellement besoin. Utilisez des terminaux en lecture seule lorsque vous souhaitez simplement que les invités voient la sortie des commandes que vous exécutez. Gardez à l’esprit que l’accès en lecture/écriture donne aux invités le même accès à votre terminal que vous. Ils peuvent exécuter n’importe quelle commande sur votre ordinateur.

Notes

Si une session de collaboration est en mode lecture seule, seuls les terminaux en lecture seule peuvent être partagés par l’hôte.

Capture d’écran montrant les choix en lecture seule et en lecture/écriture pour le niveau d’accès.

une fois que vous avez sélectionné le type de terminal partagé que vous souhaitez démarrer, un nouveau terminal partagé s’affiche dans l’onglet terminal Visual Studio Code :

Capture d’écran montrant l’onglet terminal dans Visual Studio Code.

Si plusieurs terminaux sont partagés, ou si votre focus se trouve dans un autre onglet, vous pouvez mettre le focus sur un terminal en sélectionnant l’entrée correspondante dans la liste des terminaux partagés :

Capture d’écran montrant la liste des terminaux partagés.

pour mettre fin à une session terminal, entrez exit, fermez la fenêtre de terminal ou cliquez sur le bouton annuler le partage du terminal sous l’onglet Live Share Explorer ou VS Live Share . Tout le monde sera déconnecté.

États de session et limitations

une fois que vous avez démarré ou rejoint une session de collaboration, le Visual Studio Live Share élément de barre d’état reflète l’état de la session active.

Voici les États que vous verrez généralement :

State Élément de la barre d’État Description
Inactif État de VS Code : inactif Aucune session de collaboration active. Rien n’est partagé.
Hôte : In-Progress de partage État de VS Code : partage en cours Une session de collaboration est en cours de démarrage. Le partage de contenu va bientôt commencer.
Hôte : partage État de VS Code : partage actif Une session de collaboration est active. Le contenu est partagé.
Hôte : partage en lecture seule État de VS Code : partage en lecture seule L’hôte partage une session de collaboration en lecture seule.
Invité : rejoindre une session État de Visual Studio Code : accès en cours L’invité rejoint une session de collaboration existante.
Invité : joint État de VS Code : accès réussi Guet est jointe et connectée à une session de collaboration active et reçoit du contenu partagé.
Invité : joint en lecture seule État de VS Code : accès en lecture seule L’invité est joint et connecté à une session de collaboration en lecture seule active.

Bien qu’il existe actuellement des lacunes avec les invités lorsqu’ils utilisent les fonctionnalités décrites dans cet article, les hôtes de session de collaboration conservent les fonctionnalités complètes de l’outil choisi. Pour plus d'informations, consultez les pages suivantes :

Étapes suivantes

Pour plus d’informations, consultez les articles suivants :

Vous rencontrez des problèmes ? Voir la section dépannage ou fournir des commentaires.