Partagez un projet et rejoignez une session de collaboration dans Visual Studio Code

Après avoir installé et connecté Visual Studio Live Share, partagez un projet et démarrez une session de collaboration avec votre équipe.

Rechercher des commandes Live Share

Dans le volet Live Share

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

En utilisant ces vues, vous pouvez voir l’emplacement d’un participant dans le code partagé, sélectionner les participants pour les suivre, concentrer les participants, accéder aux serveurs partagés et aux terminaux, etc.

Dans le menu de commandes délimité

Toutes les fonctions Live Share Visual Studio 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 commandes délimité à partir de la barre d’état. La sélection du bouton d’état de connexion/session dans la barre d’état affiche une liste contextuelle de commandes disponibles pour une utilisation :

Démarrer 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. Se connecter

   Après avoir installé l’extension Live Share, rechargez et attendez que les dépendances soient installées, connectez-vous pour informer d’autres collaborateurs que 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 les fichiers masqués ou exclus

   Par défaut, Live Share masque vos invités tous les fichiers et dossiers référencés dans les fichiers .gitignore dans vos dossiers partagés. Le masquage d’un fichier l’empêche d’apparaître dans l’arborescence de 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 effectuez un pas à pas dans un fichier lors du débogage ou de l’exécution de l’opération « suivi ». Pour masquer ou exclure des fichiers, ajoutez un fichier .vsls.json avec les paramètres appropriés à votre projet. Pour plus d’informations, consultez contrôle de l’accès et de la visibilité des fichiers.

4. Démarrer une session de collaboration

   Pour démarrer une session, sélectionnez Live Share dans la barre d’état ou appuyez sur Ctrl+Maj+P ou Cmd+Maj+P , puis sélectionnez Live Share : Démarrer la session de collaboration (Partager).

   

   Note

   La première fois que vous partagez, votre logiciel de pare-feu de bureau peut vous inviter à autoriser l’agent 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 la modification du mode de connexion.

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

   Vous verrez également que l’élément de barre d’état Live Share change pour représenter l’état de la session. Pour voir à quoi il ressemblera, consultez les informations d’état de session plus loin dans cet article.

   Si vous avez besoin d’obtenir à nouveau le lien d’invitation une fois que vous avez commencé à partager, vous pouvez l’obtenir en sélectionnant l’élément de barre d’état de session, puis en sélectionnant Inviter d’autres personnes (Copier le lien).

5. [Facultatif] Activer le mode lecture seule

   Après avoir 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.

   Après avoir partagé, vous recevrez une notification indiquant que le lien d’invitation a été copié dans votre presse-papiers. Vous pouvez ensuite sélectionner l’option permettant d’effectuer la session en lecture seule :

   

6. Envoyer un lien à quelqu’un

   Envoyez le lien par e-mail, Teams, Slack, Skype ou d’autres plateformes aux invités que vous souhaitez inviter. Étant donné le niveau d’accès aux sessions Live Share peuvent fournir aux invités, vous devez uniquement partager avec des personnes de confiance, et vous devez réfléchir aux implications de ce que vous partagez.

   Tip

   Vous souhaitez comprendre les implications en matière de sécurité de certaines fonctionnalités Live Share ? Pour plus d’informations, consultez l’article de sécurité .

   Les invités que vous invitez peuvent avoir des questions. L’article Guide de démarrage rapide : Rejoindre votre première session fournit des informations pour bien démarrer en tant qu’invité.

7. [Facultatif] Approuver l’invité

   Par défaut, les invités rejoignent automatiquement votre session de collaboration et vous serez averti lorsqu’ils sont prêts à travailler avec vous. Cette notification vous donne la possibilité de les supprimer de la session. Vous pouvez également choisir de demander une approbation explicite pour toute personne qui se joint.

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

   "liveshare.guestApprovalRequired": true
   

   Lorsque ce paramètre est activé, une notification vous invite à approuver les invités avant de pouvoir participer :

   

   Pour en savoir plus sur les considérations de sécurité relatives aux invitations, consultez Invitations et accès pour rejoindre.

C’est tout !

Arrêter la session de collaboration

En tant qu’hôte, vous pouvez arrêter complètement le partage et mettre fin à la session de collaboration à tout moment. Pour ce faire, ouvrez l’affichage Live Share sous l’onglet Explorateur ou l’onglet VS Live Share , puis sélectionnez 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 pourront pas accéder au contenu. Tous les fichiers temporaires seront automatiquement nettoyés.

Vous rencontrez des problèmes de partage ? Pour plus d’informations, consultez l’article de résolution des problèmes .

Rejoindre et quitter une session

Une fois qu’ils ont téléchargé et installé Visual Studio Live Share, les invités doivent suivre seulement quelques étapes pour rejoindre une session de collaboration hébergée. Il existe deux façons de joindre : via un navigateur et manuellement.

Rejoindre 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 à quoi vous attendre :

1. Se connecter

   Après avoir installé l’extension Live Share, rechargez et attendez que les dépendances soient installées, connectez-vous pour informer d’autres collaborateurs que vous êtes. Pour plus d’informations, consultez : Se connecter.

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

   Il vous suffit d’ouvrir (ou de rouvrir) le lien d’invitation dans un navigateur.

   Note

   Si vous n’avez pas installé l’extension Live Share, vous obtenez des liens vers la Place de marché. Installez l’extension, redémarrez votre outil choisi et réessayez.

   Vous devez être averti que le navigateur souhaite démarrer un outil activé pour Live Share. Si vous le laissez lancer l’outil, vous serez connecté à la session de collaboration lorsqu’elle démarrera.

   

   Si l’hôte est hors connexion, vous serez averti. Vous pouvez ensuite contacter l’hôte et lui demander de partager à nouveau.

   Note

   Vérifiez que vous avez démarré l'outil au moins une fois après avoir installé l'extension Live Share Visual Studio et autorisé l'installation à se terminer avant d'ouvrir/rouvrir la page d'invitation. Vous rencontrez toujours des problèmes ? Voir Joindre manuellement.

3. Collaborer

   C’est tout ! Dans un moment, vous serez connecté et vous pouvez commencer à collaborer.

   Le bouton Live Share s’affiche pour transmettre un état de session. Consultez les informations sur l’état de session plus loin dans cet article.

   Une fois la jointure terminée, vous êtes automatiquement redirigé vers le fichier que l’hôte modifie actuellement.

Joindre manuellement

Vous pouvez également vous joindre manuellement sans utiliser un 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 généralement ou que vous rencontrez des difficultés à obtenir des liens d’invitation au travail. Le processus est facile :

1. Se connecter

   Après avoir installé l’extension Live Share, rechargez et attendez l’installation des dépendances, connectez-vous pour informer d’autres collaborateurs que vous êtes. Pour plus d’informations, consultez : Se connecter.

2. Utiliser la commande de jointure

   Dans l’onglet Live Share de la barre d’activité de Visual Studio Code, sélectionnez le bouton ou l’élément 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. Collaborer!

   C’est tout ! Vous devriez bientôt être connecté à la session de collaboration.

   Le bouton Live Share change pour transmettre l’état de la session. Consultez des informations sur l’état de session plus loin dans cet article.

   Une fois la jointure terminée, vous êtes automatiquement redirigé vers le fichier que l’hôte modifie actuellement.

Quitter une session de collaboration

En tant qu’invité, vous pouvez quitter une session de collaboration sans la mettre fin à d’autres en fermant simplement la fenêtre Visual Studio Code. Si vous souhaitez ouvrir la fenêtre, vous pouvez ouvrir l’onglet Explorateur Live Share ou l’onglet Vs Live Share , puis sélectionner le bouton Quitter la session de collaboration :

Tous les fichiers temporaires sont automatiquement nettoyés. Vous n’avez donc rien d’autre à faire.

Vous rencontrez des problèmes pour rejoindre ? Pour plus d’informations, consultez la résolution des problèmes.

États et limitations de session

Après avoir démarré ou rejoint une session de collaboration, l’élément de la barre d’état de Visual Studio Live Share indique l’état de la session active.

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

State	Élément de barre d’état	Description
Inactif		Aucune session de collaboration active. Rien n’est partagé.
Hôte : partage de In-Progress		Une session de collaboration démarre. Le partage de contenu commencera bientôt.
Hôte : partage		Une session de collaboration est active. Le contenu est partagé.
Hôte : partage en lecture seule		L’hôte partage une session de collaboration en lecture seule.
Invité : rejoindre la session		L’invité rejoint une session de collaboration existante.
Invité : a rejoint		L’invité est joint et connecté à une session de collaboration active et reçoit du contenu partagé.
Invité : A rejoint Lecture seule		L’invité est joint et connecté à une session de collaboration en lecture seule active.

Bien qu’il y ait actuellement des lacunes que les invités connaissent lors de l’utilisation des fonctionnalités décrites dans cet article, les hôtes de session de collaboration conservent les fonctionnalités complètes de leur outil choisi. Pour en savoir plus, consultez :

• Prise en charge du langage et de la plateforme
• Prise en charge des extensions
• Tous les bogues majeurs, demandes de fonctionnalités et limitations
• Toutes les demandes et limitations de fonctionnalités
• Résolution des problèmes

Étapes suivantes