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

Important

Visual Studio Live Share est en mode maintenance, sans fonctionnalités supplémentaires planifiées.

Les fonctionnalités existantes restent disponibles. Utilisez cette documentation pour obtenir des instructions opérationnelles et des fonctionnalités actuelles. Pour plus d’informations, consultez Mode de maintenance pour Visual Studio Live Share.

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

Partager un projet

Suivez ces étapes pour démarrer une session de collaboration et inviter un collègue à travailler avec vous.

  1. Se connecter

    Maintenant que vous êtes connecté, vous êtes prêt à démarrer votre propre session de collaboration. Vous n’êtes pas connecté ? Pour plus d’informations, consultez la connexion.

  2. Ouvrir une solution, un projet ou 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 tous les fichiers ou dossiers référencés dans les fichiers .gitignore de votre projet à partir d’invités. Masquer un fichier l’empêche d’apparaître dans l’arborescence des fichiers, tandis que l’exclure l’empêche d’être transmis, y compris lors d’opérations comme le débogage. Si vous souhaitez masquer ou exclure des fichiers différents, un fichier .vsls.json peut être ajouté à votre projet avec ces paramètres. Pour plus d’informations, consultez le contrôle de l’accès aux fichiers et la visibilité .

  4. Démarrer une session de collaboration

    Sélectionnez le bouton Live Share dans le coin supérieur droit pour démarrer une session Live Share. Un lien de partage vers votre session de collaboration est automatiquement copié dans votre presse-papiers.

    Screenshot qui affiche le bouton Live Share lors de la connexion à Visual Studio.

    Lorsque vous démarrez votre session de collaboration pour la première fois, vous verrez une fenêtre d’outil Live Share. Veillez à ancrer cette fenêtre pour vous assurer qu’elle s’affiche la prochaine fois que vous démarrez une session Live Share.

    Screenshot qui affiche la fenêtre outil Live Share dans Visual Studio.

    Note

    Vous pouvez être invité par votre logiciel de pare-feu de bureau à autoriser l’agent Live Share à ouvrir un port la première fois que vous partagez. L’acceptation de ce problème est entièrement facultative, mais permet un mode direct sécurisé pour améliorer les performances lorsque la personne avec laquelle vous travaillez est sur le même réseau que vous le êtes. Pour plus d’informations, consultez la modification du mode de connexion .

  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. Ce mode empêche les invités d’apporter des modifications au code que vous partagez.

    Après le partage, vous recevez une notification indiquant que le lien d’invitation a été copié dans votre Presse-papiers. Vous pouvez ensuite sélectionner l’option permettant de rendre la session en lecture seule.

    Capture d’écran montrant l’option « Créer en lecture seule » dans la bannière du lien d’invitation.

  6. Envoyer un lien à quelqu’un

    Envoyez le lien par e-mail, Teams, Slack, Skype ou une autre application de communication à toute personne que vous souhaitez inviter. Compte tenu du niveau d’accès que les sessions Live Share peuvent accorder aux invités, vous ne devez les partager qu’avec des personnes de confiance. Réfléchissez attentivement aux implications de ce que vous partagez.

    Tip

    Vous souhaitez comprendre les implications en matière de sécurité de certaines des fonctionnalités de Live Share ? Consultez l’article sur la sécurité .

    Si la personne que vous avez invitée a des questions, l’article Démarrage rapide : rejoindre votre première session fournit plus d’informations pour bien démarrer en tant qu’invité.

  7. [Facultatif] Approuver l’invité

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

    Accédez à Outils > Options > Live Share >, puis modifiez Exiger l’approbation de l’invité sur True pour activer la fonctionnalité. Une fois que vous avez activé ce paramètre, une notification vous invite à approuver l’invité avant de pouvoir participer.

    Capture d’écran montrant une demande d’approbation d’adhésion à Visual Studio.

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

  8. Gérer votre session Live Share

    Une fois que votre invité a ouvert le lien vers votre session partagée dans Visual Studio Code ou Visual Studio, vous les verrez répertoriés sous les participants dans la fenêtre de l'outil Live Share. Vous pouvez maintenant voir dans quel fichier votre invité se trouve actuellement à côté de son nom.

    Screenshot qui affiche la fenêtre de l’outil Live Share Visual Studio affichant un participant.

    La fenêtre de l’outil Live Share vous permet d’accéder à toutes les fonctionnalités clés pour gérer votre session à un seul endroit.

    Tip

    Impossible de voir la fenêtre de l’outil Live Share pendant vos sessions ? Vous pouvez toujours sélectionner Partage > Afficher la fenêtre Live Share pour l’ouvrir !

Mettre fin à la session de collaboration

En tant qu’hôte, vous pouvez arrêter complètement le partage et mettre fin à la session de collaboration en sélectionnant le bouton Partager dans le coin supérieur droit et en sélectionnant End Live Share Session.

Capture d’écran montrant la sélection du partage, puis la sélection de la session End Live Share dans la liste déroulante.

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

Vous rencontrez des problèmes avec le partage ? Consultez la résolution des problèmes.

Participer à une session de collaboration

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

Tip

En tant qu’invité qui rejoint une session de collaboration, il est important de comprendre que les hôtes peuvent restreindre votre accès à certains fichiers ou fonctionnalités. Vous souhaitez comprendre les implications de sécurité de certaines des fonctionnalités et paramètres de Live Share ? Pour plus d’informations, consultez l’article de sécurité .

Rejoindre via le navigateur

Le moyen le plus simple de rejoindre une session de collaboration consiste à ouvrir le lien d’invitation dans un navigateur web. Voici ce que vous pouvez vous attendre lorsque vous suivez ce flux.

  1. Se connecter

    Après avoir installé l’extension Live Share, vous devez vous connecter pour informer d’autres collaborateurs de savoir qui vous êtes. Visual Studio utilise votre compte de personnalisation par défaut. Vous pouvez donc ignorer cette étape.

    Pour plus d’informations, consultez la connexion.

  2. Cliquez sur le lien d’invitation ou ouvrez l’invitation dans votre navigateur

    Ouvrez, ou ouvrez à nouveau, le lien d’invitation dans un navigateur.

    Note

    Si vous n’avez pas installé l’extension Live Share, vous êtes présenté avec des liens vers la Place de marché d’extension. Installez l’extension, redémarrez votre outil et réessayez.

    Vous serez averti que le navigateur souhaite lancer un outil Live Share activé. Si vous l’avez laissé lancer votre outil sélectionné, vous serez connecté à la session de collaboration une fois qu’elle démarre.

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

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

    Note

    Vous rencontrez toujours des problèmes ? Pour plus d’informations, consultez rejoindre manuellement.

  3. Collaborer

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

    Vous verrez la transition du bouton Live Share pour transmettre un état de session. Consultez les informations d’état de session ci-dessous pour connaître l’apparence du bouton.

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

Joindre manuellement

Vous pouvez joindre manuellement sans utiliser un navigateur web. Le rattachement manuel est utile dans les cas où l’outil que vous souhaitez utiliser est déjà en cours d’exécution. Utilisez la jointure manuelle si vous souhaitez utiliser un autre outil que celui que vous utilisez habituellement. Vous pouvez également l’utiliser si vous rencontrez des difficultés pour obtenir des liens d’invitation à travailler pour une raison quelconque.

  1. Se connecter

    Après avoir installé l’extension Live Share, vous devez vous connecter pour informer d’autres collaborateurs de savoir qui vous êtes. Visual Studio utilise votre compte de personnalisation par défaut. Vous pouvez donc ignorer entièrement cette étape.

    Pour plus d’informations, consultez la connexion.

  2. Utiliser la commande de jointure

    Allez dans Fichier > Rejoindre une session Live Share.

    Capture d’écran montrant le menu Fichier de Visual Studio avec l’option Join Live Share Session sélectionnée.

  3. Coller le lien d’invitation

    Collez l’URL d’invitation et confirmez.

  4. Collaborer

    C’est tout ! Vous devez être connecté à la session de collaboration momentanément.

    Vous verrez la transition du bouton Live Share pour transmettre un état de session. Pour plus d’informations sur l’apparence du bouton, consultez l’état de session.

    Vous êtes automatiquement redirigé vers l’emplacement où l’hôte est en cours de modification une fois la jointure terminée.

Quitter la session de collaboration

En tant qu’invité, vous pouvez quitter la session de collaboration sans la mettre fin à d’autres en fermant l’outil.

Screenshot qui affiche le menu Visual Studio Live Share lorsqu’il est joint à une session de collaboration.

Vous pouvez également quitter la session en cliquant sur le bouton Partager et en sélectionnant Quitter la session de partage en direct.

Tous les fichiers temporaires sont automatiquement nettoyés afin qu’aucune action supplémentaire ne soit nécessaire.

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

États de session

Une fois que vous avez démarré ou rejoint une session de collaboration et que vous avez accès au contenu partagé, le bouton Live Share dans le coin supérieur droit met à jour son apparence pour refléter l’état de la session de collaboration active.

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

State Button Description
Inactif Capture d’écran montrant le bouton Live Share dans un état de session inactif. Aucune session de collaboration active et rien n’est partagé.
Hôte : partage de In-Progress Capture d’écran montrant le bouton Live Share dans un partage en cours de session. Une session de collaboration démarre et le partage de contenu commence bientôt.
Hôte : partage Capture d’écran montrant le bouton Live Share dans un état de session actif de partage. Une session de collaboration est active et le contenu est partagé.
Hôte : partage en lecture seule Capture d’écran montrant le bouton Live Share dans un état de session en lecture seule de partage. Partage d’une session de collaboration en lecture seule.
Invité : rejoindre la session Capture d’écran montrant le bouton Live Share dans un état de session de jointure. Rejoindre une session de collaboration existante.
Invité : a rejoint Capture d’écran montrant le bouton Live Share dans un état de session joint. A rejoint une session de collaboration active, y est connecté et reçoit du contenu partagé.
Invité : A rejoint Lecture seule Capture d’écran montrant le bouton Live Share dans un état de session en lecture seule joint. A rejoint une session active de collaboration en lecture seule et s’y est connecté.

Étapes suivantes