Colaboración mediante Visual Studio CodeHow-to: Collaborate using Visual Studio Code

¿Está listo para empezar a colaborar con Live Share en VS Code?Ready to get collaborating with Live Share in VS Code? Si es así, está en el lugar correcto.If so, you're in the right spot! En este artículo, lo guiaremos para que aprenda a usar algunas de las características específicas de la extensión Visual Studio Live Share para Visual Studio Code.In this article, we'll walk you through how to use some of the specific features in the Visual Studio Live Share extension for Visual Studio Code.

Tenga en cuenta que todas las actividades de colaboración que se describen aquí implica un único anfitrión de la sesión de colaboración y uno o varios invitados.Note that all collaboration activities described here involve a single collaboration session host and one or more guests. El anfitrión es la persona que inicia la sesión de colaboración, mientras que las personas que participan en ella son invitados.The host is the person that started the collaboration session and anyone that joins is a guest.

¿Busca un resumen abreviado? Consulte entonces los inicios rápidos sobre cómo compartir o participar.Looking for an abridged summary? Check out the share or join quickstarts instead.

Sugerencia

¿Sabía que puede participar en su propia sesión de colaboración?Did you know you can join your own collaboration session? Esto le permite probar Live Share por su cuenta o poner en marcha una instancia de Visual Studio o VS Code y conectarse a ella de forma remota.This allows you to try Live Share on your own or to spin up an instance of Visual Studio or VS Code and connect to it remotely! Incluso puede usar la misma identidad en ambas instancias.You can even use the same identity in both instances. ¡Compruébelo!Check it out!

InstalaciónInstallation

Antes de empezar, deberá asegurarse de tener instalada una versión de Visual Studio Code que cumpla los requisitos principales de Live Share.Before you begin, you'll need to be sure you've got a version of Visual Studio Code installed that meets Live Share's core requirements. Necesitará Visual Studio Code (1.22.0 superior) que se ejecute en:You'll need Visual Studio Code (1.22.0 or higher) running on:

  • Windows: 7, 8.1 o 10Windows: 7, 8.1, or 10

  • macOS: Sierra (10.12) y versiones superiores solamente.macOS: Sierra (10.12) and above only.

  • Linux: Ubuntu Desktop 16.04 de 64 bits o versiones posteriores, Fedora Workstation 27 o versiones posteriores, CentOS 7Linux: 64-bit Ubuntu Desktop 16.04+, Fedora Workstation 27+, CentOS 7

Después, descargar e instalar la extensión de Visual Studio Live Share es muy sencillo:After that, downloading and installing the Visual Studio Live Share extension is a breeze:

  1. Instalación de Visual Studio CodeInstall Visual Studio Code
  2. Descargue e instale la extensión Visual Studio Live Share desde Marketplace.Download and install the Visual Studio Live Share extension from the marketplace.
  3. Recarga de Visual Studio CodeReload Visual Studio Code
  4. Espere que las dependencias se descarguen e instalen (consulte la barra de estado).Wait for dependencies to download and install (see status bar).
    Finalización de la instalaciónFinishing install
  5. Linux: Si ve una notificación sobre la instalación de bibliotecas que faltan:Linux: If you see a notification about installing missing libraries:
    1. Haga clic en "Instalar" en la notificación.Click "Install" in the notification.
    2. Escriba la contraseña de administrador (sudo) cuando se le solicite.Enter your admin (sudo) password when prompted.
    3. Cuando termine, reinicie VS Code.Restart VS Code when done.

Al descargar y usar Visual Studio Live Share, acepta los términos de licencia y la declaración de privacidad.By downloading and using Visual Studio Live Share, you agree to the license terms and privacy statement. Si surge algún problema, consulte la solución de problemas.See troubleshooting if you run into problems.

DescargaDownload

Pasos de instalación de LinuxLinux install steps

Linux es un entorno altamente variable y con el gran número de distribuciones y entornos de escritorio puede ser complicado hacerlo funcionar.Linux is a highly variable environment and with the sheer number of desktop environments and distributions can be complicated to get working. Si se limita a las versiones compatibles de Ubuntu Desktop (16.04 o posteriores) o de Fedora Workstation (27 o posteriores), CentOS 7 y solo usa distribuciones oficiales de VS Code, debería encontrar que el proceso es sencillo.If you stick to supported versions of Ubuntu Desktop (16.04+) or Fedora Workstation (27+), CentOS 7 and only use official distributions of VS Code, you should find the process straightforward. Sin embargo, en caso de que use una configuración no estándar o una configuración de nivel inferior, es posible que se encuentre (o no) con algunas interrupciones.However, in the event that you are using a non-standard configuration or downstream distribution, you may or may not run into some hiccups. Consulte Detalles de la instalación de Linux para obtener más información.See Linux installation details for more information.

Instalación de los requisitos previos de LinuxInstall Linux prerequisites

En algunas distribuciones de Linux faltan bibliotecas que Live Share necesita para funcionar.Some distributions of Linux are missing libraries Live Share needs to function. De manera predeterminada, Live Share intenta detectar e instalar los requisitos previos de Linux.By default, Live Share attempts to detect and install Linux prerequisites for you. Verá una notificación del sistema cuando Live Share encuentre un problema que pueda provenir de la falta de bibliotecas en la que se le pedirá permiso para instalarlas.You'll see a toast notification when Live Share encounters a problem that can originate from missing libraries asking you for permission to install them.

Notificación del sistema que muestra el mensaje de que faltan algunos requisitos previos de Linux

Al hacer clic en "Instalar", aparecerá una ventana de terminal en la que tendrá que escribir la contraseña de administrador (sudo) para continuar.When you click "Install", a terminal window will appear where you'll need to enter your admin (sudo) password to continue. Si todo se completa correctamente, todo debería estar listo una vez que reinicie Visual Studio Code.Assuming it completes successfully, restart Visual Studio Code you should be all set! También puede consultar las sugerencias de distribución para ver otras indicaciones y soluciones alternativas que puedan existir.You may also want to check out tips by distribution for other hints and workarounds if any exist.

Si ve un mensaje que indica que el script no es compatible con la distribución, consulte las sugerencias para las distribuciones compatibles con la comunidad para ver la información que la comunidad nos ha compartido.If you see a message indicating the script does not support your distribution, see tips for community supported distributions for information the community has shared with us.

Si prefiere que VS Code no ejecute el comando por usted, también puede optar por volver a ejecutar la versión más reciente de este script en cualquier momento de manera manual mediante la ejecución del comando siguiente desde una ventana del terminal:If you prefer not to have VS Code run the command for you, you can also opt to re-run the very latest version of this script at any time manually by running the following command from a Terminal window:

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

Integración del explorador de LinuxLinux browser integration

Por lo general, Visual Studio Live Share no necesita pasos de instalación adicionales para habilitar la integración del explorador en Linux.Visual Studio Live Share typically does not require additional installation steps to enable browser integration on Linux.

Si bien es poco habitual, en ciertas distribuciones es posible que reciba una notificación de que se necesita su contraseña de administración (sudo) para completar el proceso de instalación.While uncommon, on certain distributions you may be notified that your admin (sudo) password is required to complete the installation process. Aparecerá una ventana de terminal en la que se le indicará que se instalará el iniciador del explorador.A terminal window will appear telling you where the browser launcher will be installed. Para cerrar la ventana de terminal, solo debe escribir la contraseña cuando se le solicite y presionar ENTRAR una vez que la instalación termine.Simply enter your password when prompted and press enter once the installation completes to close the terminal window.

Aquí puede leer más sobre por qué es necesario este paso y dónde coloca los archivos Live Share.You can read more about why this is required and where Live Share places files here. Observe que, incluso si no puede hacer funcionar la integración del explorador, de todos modos puede participar manualmente en las sesiones de colaboración .Note even if you are unable to get browser integration working you can still join collaboration sessions manually.

Inicio de sesiónSign in

Para poder colaborar, deberá iniciar sesión en Visual Studio Live Share de manera que todos sepan quién es usted.In order to collaborate, you'll need to sign into Visual Studio Live Share so everyone knows who you are. Esto no es más que una medida de seguridad y no significa que se inscriba en ninguna actividad de marketing u otro tipo de investigación.This is purely a security measure and does not opt you into any marketing or other research activities. Puede iniciar sesión con una cuenta personal de Microsoft (por ejemplo, @outlook.com), una cuenta profesional o educativa (AAD) con el respaldo de Microsoft, o bien una cuenta de GitHub.You can sign in using a Microsoft personal account (e.g. @outlook.com), Microsoft-backed work or school account (AAD), or a GitHub account. Es fácil iniciar sesión.Signing in is easy.

Haga clic en el elemento de la barra de estado "Live Share" o presione Ctrl+Mayús+P / Cmd+Mayús+P y seleccione el comando "Live Share: Sign In With Browser" (Live Share: iniciar sesión con el explorador).Click on the "Live Share" status bar item or press Ctrl+Shift+P / Cmd+Shift+P and select the "Live Share: Sign In With Browser" command.

Botón de inicio de sesión de VS Code

Aparecerá una notificación para pedirle que inicie sesión con el explorador web.A notification will appear asking you to sign in using your web browser. Si hace clic en "launch sign in" (Iniciar inicio de sesión) se abrirá un explorador que puede usar para completar el proceso de inicio de sesión.Clicking "launch sign in" will open a browser for you to use to complete the sign-in process. Cuando termine, simplemente cierre el explorador.Simply close the browser when done.

Notificación del sistema en la que solicita el inicio de sesión con un explorador web

Usuarios de Linux: Se le pedirá que escriba un código de usuario si usa una versión antigua de Live Share (versión 0.3.295 o inferior).Linux users: You may be prompted to enter a user code if you are using an older version of Live Share (v0.3.295 or below). Actualice a la versión más reciente de la extensión o haga clic en el vínculo "¿Tiene problemas?"Update to the latest version of the extension or click the "Having trouble?" después de iniciar sesión para ver el código.link after sign in to see the code. Para información más detallada, consulte a continuación.See below for details.

Sugerencia avanzada: Las opciones liveshare.account y liveshare.accountProvider le permiten seleccionar qué cuenta debería usarse para el inicio de sesión automático en caso de que disponga de credenciales almacenadas en caché para varias cuentas disponibles.Advanced tip: The liveshare.account and liveshare.accountProvider settings enable you to select which account should be used for automatic sign-in in case you have cached credentials for multiple accounts available. Por ejemplo, imagine que trabaja en dos proyectos en los que quiere iniciar sesión con identidades distintas.For example, imagine you work on 2 projects with which you want to sign in with different identities. En la configuración del área de trabajo de VSCode, puede configurar la opción liveshare.account para distintas direcciones de correo electrónico en cada directorio de proyecto. De este modo, se asegurará de que la sesión de cada una de ellas se inicia automáticamente con la cuenta adecuada.In your VSCode workspace settings, you could set the liveshare.account setting to different email addresses in each project directory to ensure they each automatically sign-in with the correct account. La opción liveshare.accountProvider se puede establecer tanto en "microsoft" como "github" si usa la misma dirección de correo electrónico con varios proveedores.The liveshare.accountProvider setting could be set to either "microsoft" or "github" in case you use the same email address with multiple providers.

Si Visual Studio Code no acepta su inicio de sesión una vez que completa el proceso en el explorador, consulte Inicio de sesión con un código de usuario.If Visual Studio Code is not picking up your sign in after you complete the sign-in process in the browser, see sign in using a user code. En caso contrario, revise la solución de problemas para ver más sugerencias.Otherwise, check out troubleshooting for more tips.

Inicio de sesión con un código de usuarioSign in using a user code

Si tiene problemas para que VS Code acepte un inicio de sesión completado, puede escribir un "código de usuario" en su lugar.If you are running into problems with VS Code not picking up a completed sign in, you can enter a "user code" instead.

  1. Presione Ctrl+Mayús+P / Cmd+Mayús+P y ejecute el comando "Live Share: Sign in with user code" (Live Share: iniciar sesión con código de usuario).Press Ctrl+Shift+P / Cmd+Shift+P and run the "Live Share: Sign in with user code" command.

  2. Debería aparecer un explorador donde completar el proceso de inicio de sesión.A browser should appear for you use to complete the sign-in process.

    Nota

    Si no aparece automáticamente, abra esta ubicación en un explorador e inicie sesión.If a browser does not appear automatically, open this location in a browser and sign in.

  3. Una vez que termine, haga clic en "Having trouble?Once you are done, click "Having trouble? Click here for user code directions" (¿Problemas? Haga clic aquí para instrucciones sobre el código de usuario) para ver el código de usuario.Click here for user code directions" to see the user code.

    Imagen del código de usuario en un explorador

  4. Copie el código de usuario.Copy the user code.

  5. Por último, péguelo en el campo de entrada que apareció cuando ejecutó el comando y presione ENTRAR para completar el proceso de inicio de sesión.Finally, paste the user code into the input field that appeared when you ran the command and press enter to complete the sign-in process.

    Imagen del campo de entrada de código de usuario

Uso del viewlet de Live ShareUsing the Live Share viewlet

Después de instalar Visual Studio Live Share, se agregará una pestaña personalizada a la barra de actividades de VS Code.After installing Visual Studio Live Share, a custom tab will be added to the VS Code activity bar. En esta pestaña, podrá acceder a todas las funciones de Live Share para colaborar.In this tab, you can access all Live Share functions to collaborate. Además, cuando se une a una sesión de colaboración o la comparte, también aparecerá una vista en la pestaña Explorador para que acceda a todas esas funciones.Additionally, when you share or join a collaboration session, a view will also appear in the Explorer tab for you to access all these functions as well.

Live Share custom tab Live Share explorer view

Con estas vistas, puede ver la ubicación de un participante en el código compartido, hacer clic en un participante para seguirlo, atraer la atención de los participantes, acceder a terminales y servidores compartidos, etc.With these views, you can see a participant's location in the shared code, click on a participant to follow them, focus participants, access shared servers and terminals, and more.

Uso del menú de comandos con ámbitoUsing the scoped command menu

Además, todas las funciones de Visual Studio Live Share están disponibles desde la "paleta de comandos" de Visual Studio Code a la que se puede acceder con Ctrl+Mayús+P o Cmd+Mayús+P o F1.Additionally, all Visual Studio Live Share functions are available from the Visual Studio Code "Command Palette" that can be accessed by pressing Ctrl+Shift+P / Cmd+Shift+P or F1. Para encontrar una lista completa de los comandos, escriba "live share".You can find a complete list of commands by typing "live share".

Como esta lista puede ser larga, quizás le resulte más fácil usar un menú de comandos con ámbito que está disponible en la barra de estado.Since this list can get long, you may find it easier to take advantage of a scoped command menu available from the status bar. Si hace clic en el icono de inicio de sesión/estado de sesión de la barra de estado se abrirá una lista contextualizada de los comandos disponibles para su uso.Clicking on the sign in / session state icon in the status bar will immediately bring up a contextualized list of commands that are available for you to use.

Icono de estado de sesión de VS Code

Uso compartido de un proyectoShare a project

Después de descargar e instalar Visual Studio Live Share, siga estos pasos para iniciar una sesión de colaboración e invitar a un compañero de trabajo a trabajar con usted.After downloading and installing Visual Studio Live Share, follow these steps to start a collaboration session and invite a colleague to work with you.

  1. Iniciar sesiónSign in

    Después de instalar la extensión Live Share, recargar y esperar a que se terminen de instalar las dependencias, querrá iniciar sesión para que otros colaboradores sepan quién es.After installing the Live Share extension, reloading, and waiting for dependencies to finish installing, you'll want to sign in to let other collaborators know who you are. Consulte Inicio de sesión para más detalles.See sign in for more details.

  2. Abrir una carpetaOpen a folder

    Use el flujo de trabajo normal para abrir una carpeta, un proyecto o una solución que quisiera compartir con los invitados.Use your normal workflow to open a folder, project, or solution you would like to share with your guests.

  3. [Opcional] Actualizar los archivos ocultos o excluidos[Optional] Update hidden or excluded files

    De manera predeterminada, Live Share oculta a los invitados los archivos o carpetas a los que se hace referencia en los archivos .gitignore de las carpetas compartidas.By default, Live Share hides any files/folders referenced in .gitignore files in your shared folders from guests. Ocultar un archivo evita que aparezca en el árbol de archivos del invitado.Hiding a file prevents it from appearing in the guest's file tree. Excluir un archivo aplica una regla más estricta que impedirá que Live Share lo abra para el invitado en situaciones como ir a una definición o cuando el archivo se depura paso a paso por instrucciones mientras depura o se "sigue".Excluding a file applies a stricter rule that will prevent Live Share from opening it for the guest in situations like go to a definition or if you step into the file while debugging or being "followed". Si quiere ocultar o excluir otros archivos, puede agregar un archivo .vsls.json al proyecto con esta configuración.If you want to hide/exclude different files, a .vsls.json file can be added to your project with these settings. Consulte Control de la visibilidad y el acceso de archivos para más información.See controlling file access and visibility for details.

  4. Iniciar una sesión de colaboraciónStart a collaboration session

    Ahora, simplemente haga clic en el elemento de la barra de estado "Live Share" o presione Ctrl+Mayús+P / Cmd+Mayús+P y seleccione "Live Share: Start a collaboration session (Share)" (Live Share: iniciar una sesión de colaboración [Compartir]).Now, simply click the "Live Share" status bar item or hit Ctrl+Shift+P / Cmd+Shift+P and select "Live Share: Start a collaboration session (Share)".

    Botón Compartir

    Nota

    La primera vez que comparta, es posible que el software de firewall de escritorio le pida que permita que el agente de Live Share abra un puerto.You may be asked by your desktop firewall software to allow the Live Share agent to open a port the first time you share. Aceptar esto es totalmente opcional, pero habilita un "modo directo" seguro para mejorar el rendimiento cuando la persona con la que trabaja se encuentra en la misma red que usted.Accepting this is entirely optional but enables a secured "direct mode" to improve performance when the person you are working with is on the same network as you are. Consulte Cambiar el modo de conexión para más detalles.See changing the connection mode for details.

    Un vínculo a la invitación se copiará automáticamente en el Portapapeles.An invite link will be automatically copied to your clipboard. Cuando se abre en un explorador, este vínculo permite que otros usuarios se unan a una sesión de colaboración donde se les comparte contenido de estas carpetas.When opened in a browser, this link allows others to join a new collaboration session that shares contents of these folders with them.

    También verá la transición del elemento de la barra de estado "Live Share" para representar el estado de sesión.You will also see the "Live Share" status bar item transition to represent the session state. Consulte la información sobre el estado de sesión que aparece a continuación para saber cuál es el aspecto.See session state information below for what this looks like.

    Tenga en cuenta que si necesita obtener nuevamente el vínculo de la invitación una vez que haya empezado a compartir los recursos, puede acceder a él otra vez si hace clic en el icono de estado de sesión de la barra de estado y selecciona "Invite Others (Copy Link)" (Invitar a otros [copiar vínculo]).Note that if you need to get the invite link again after you've started sharing, you access it again by clicking on the session state status bar icon and select "Invite Others (Copy Link)".

  5. [Opcional] Habilitar el modo de solo lectura[Optional] Enable read-only mode

    Una vez iniciada la sesión de colaboración, puede establecerla para que sea de solo lectura a fin de evitar que los invitados realicen cambios en el código que se comparte.Once you start your collaboration session, you can set the session to be read-only to prevent guests from making edits to the code being shared.

    Después de compartir, recibirá una notificación en la que se indica que el vínculo de invitación se ha copiado en el Portapapeles.After sharing, you will get a notification that the invite link has been copied to your clipboard. Después, puede seleccionar la opción para hacer que la sesión sea de solo lectura.You can then select the option to make the session read-only.

    Modo de solo lectura de VS

  6. Enviar el vínculo a alguienSend someone the link

    Envíe el vínculo por correo electrónico, Slack, Skype, etc., a los usuarios que quiera invitar.Send the link over e-mail, Slack, Skype, etc. to those you want to invite. Tenga en cuenta que, dado el nivel de acceso que las sesiones de Live Share pueden proporcionar a los invitados, solo se debe compartir con usuarios de confianza, y piense detenidamente en las implicaciones de lo que va a compartir.Note that, given the level of access Live Share sessions can provide to guests, you should only share with people you trust and think through the implications of what you are sharing.

    Sugerencia de seguridad: ¿Quiere conocer las implicaciones de seguridad de algunas de las características de Live Share?Security Tip: Want to understand the security implications of some of Live Share's features? Consulte el artículo sobre seguridad.Check out the security article.

    Si el invitado al que invitó tiene preguntas, en el artículo "Quickstart: Join your first session" (Inicio rápido: Participación en una primera sesión) se proporciona información adicional sobre cómo prepararlo todo para participar como invitado.If the guest you invited has questions, the "Quickstart: Join your first session" article provides some more information on getting up and running as a guest.

  7. [Opcional] Aprobar al invitado[Optional] Approve the guest

    De manera predeterminada, los invitados participarán automáticamente en la sesión de colaboración y se le notificará cuando estén listos para trabajar con usted.By default, guests will automatically join your collaboration session and you'll be notified when they're ready to work with you. Si bien esta notificación le da la opción de quitarlos de la sesión, también puede optar por requerir una "aprobación" explícita para todo aquel que se una.While this notification gives you the option to remove them from the session, you can also opt to instead require an explicit "approval" for anyone joining.

    Para habilitar esta característica, simplemente agregue lo siguiente a settings.json:To enable this feature, simply add the following to settings.json:

      "liveshare.guestApprovalRequired": true
    

    Una vez que active esta configuración, recibirá una notificación que le pedirá aprobar al invitado antes de que pueda participar.Once you have this setting turned on, a notification will prompt you to approve the guest before they can join.

    Solicitud de aprobación de participación en Visual Studio Code

    Consulte Invitations and join access (Invitaciones y acceso de participación) para más detalles sobre las consideraciones de seguridad en la invitación.See invitations and join access for additional details on invitation security considerations.

¡Y listo!That's it!!

Detención de la sesión de colaboraciónStop the collaboration session

Como anfitrión, puede dejar de compartir completamente y finalizar la sesión de colaboración en cualquier momento si abre la vista de Live Share en el Explorador o en la pestaña personalizada Live Share y selecciona el icono "Stop collaboration session" (Detener sesión de colaboración).As a host, you can stop sharing completely and end the collaboration session at any time by opening the Live Share view in the Explorer or in the Live Share custom tab and selecting the "Stop collaboration session" icon.

Detener sesión de colaboración

Todos los invitados recibirán una notificación de que finalizó la sesión.All guests will be notified that the session has ended. Una vez finalizada la sesión, los invitados ya no podrán acceder al contenido y los archivos temporales se borrarán automáticamente.Once the session has ended, guests will no longer be able to access the content and any temp files are automatically cleaned up.

¿Tiene problemas para compartir recursos?Having issues with sharing? Revise la solución de problemas.Check out troubleshooting.

Participación en una sesión de colaboraciónJoin a collaboration session

Después de descargar e instalar Visual Studio Live Share, los invitados solo deben realizar un par de pasos para participar en una sesión de colaboración hospedada.After downloading and installing Visual Studio Live Share, guests only need to take a couple of steps to join a hosted collaboration session. Hay dos maneras de participar: a través del explorador y manualmente.There are two ways to join: via the browser and manually.

Sugerencia de seguridad: Como invitado que participa en una sesión de colaboración, es importante comprender que los hosts pueden limitar el acceso a determinados archivos o características.Security Tip: As a guest joining a collaboration session, it's important to understand that hosts may restrict your access to certain files or features. ¿Quiere conocer las implicaciones de seguridad de algunas de las características y configuraciones de Live Share?Want to understand the security implications of some of Live Share's features and settings? Consulte el artículo sobre seguridad.Check out the security article.

Participar a través del exploradorJoin via the browser

La manera más sencilla de participar en una sesión de colaboración es abrir el vínculo de la invitación en un explorador web.The easiest way to join a collaboration session is to simply open the invite link in a web browser. Esto es lo que puede esperar si sigue este flujo.Here's what you can expect when you follow this flow.

  1. Inicio de sesiónSign in

    Después de instalar la extensión Live Share, recargar y esperar a que se terminen de instalar las dependencias, querrá iniciar sesión para que otros colaboradores sepan quién es.After installing the Live Share extension, reloading, and waiting for dependencies to finish installing, you'll want to sign in to let other collaborators know who you are. Consulte Inicio de sesión para más detalles.See sign in for more details.

  2. Haga clic en el vínculo de la invitación o abra la invitación en el exploradorClick on the invite link / open the invite in your browser

    Ahora, basta con abrir (o volver a abrir) el vínculo de invitación en un explorador.Now, simply open (or re-open) the invite link in a browser.

    Nota: Si aún no ha instalado la extensión Live Share, se le mostrarán vínculos al Marketplace de la extensión.Note: If you have not yet installed the Live Share extension, you'll be presented with links to the extension marketplace. Instale la extensión, reinicie la herramienta e inténtelo de nuevo.Install the extension and restart your tool and retry.

    Debería recibir una notificación en la que se indica que el explorador quiere iniciar una herramienta habilitada para Live Share.You should be notified that the browser wants to launch a Live Share enabled tool. Si permite que inicie la herramienta seleccionada, se conectará a la sesión de colaboración una vez que se inicie.If you let it launch your selected tool, you'll be connected to the collaboration session once it starts.

    Página para participar

    Si el host está sin conexión, se le notificará en este momento.If the host is offline, you'll be notified at this point instead. Después, puede ponerse en contacto con el anfitrión y pedirle que vuelva a compartir.You can then contact the host and ask them to share again.

    Nota

    Asegúrese de haber iniciado la herramienta al menos una vez después de instalar la extensión Visual Studio Live Share y permitido que la instalación se realice completamente antes de abrir o volver a abrir la página de invitación.Be sure you've started the tool at least once after installing the Visual Studio Live Share extension and allowed the installation to finish before opening/re-opening the invite page. ¿Sigue teniendo problemas?Still having trouble? Consulte Participar manualmente.See join manually.

  3. ColaboreCollaborate

    Ya está.That's it! En unos instantes se conectará y podrá empezar a colaborar.In a few moments you'll be connected and you can start collaborating.

    Verá la transición del botón "Live Share" a convertirse en un "Estado de sesión".You will see the "Live Share" button transition to convey a "Session State". Consulte la información sobre el estado de sesión que aparece a continuación para saber cuál es el aspecto.See session state information below for what this looks like.

    Luego pasará automáticamente al archivo que actualmente está editando el anfitrión una vez que se una por completo.You'll then be automatically taken to the file the host is currently editing once the join is complete.

Participar manualmenteJoin manually

También puede participar manualmente sin usar un explorador web, lo que puede ser útil cuando la herramienta que quiere usar ya está en ejecución, si quiere una herramienta distinta a la que usa con frecuencia o si, por alguna razón, tiene problemas para que los vínculos de invitación funcionen.You can also manually join without using a web browser which can be useful in situations where the tool you want to use is already running, you want to use a different tool than you usually do, or if you are having trouble with getting invite links to work for some reason. El proceso es sencillo:The process is easy:

  1. Inicie sesiónSign in

    Después de instalar la extensión Live Share, recargar y esperar a que se terminen de instalar las dependencias, querrá iniciar sesión para que otros colaboradores sepan quién es.After installing the Live Share extension, reloading, and waiting for dependencies to finish installing, you'll want to sign in to let other collaborators know who you are. Consulte Inicio de sesión para más detalles.See sign in for more details.

  2. Use el comando para participarUse the join command

    Abra la pestaña personalizada Live Share en la barra de actividades de VS Code y seleccione la entrada o el icono "Join collaboration session…" (Participar en la sesión de colaboración).Open the Live Share custom tab in the VS Code activity bar, and select the "Join collaboration session..." icon or entry.

    Icono para participar del viewlet

  3. Pegue el vínculo de invitaciónPaste the invite link

    Pegue la dirección URL de la invitación que le enviamos y presione ENTRAR para confirmar.Paste in the invite URL you were sent and hit enter to confirm.

  4. ¡Colabore!Collaborate!

    Ya está.That's it! Debería estar conectado momentáneamente a la sesión de colaboración.You should be connected to the collaboration session momentarily.

    Verá la transición del botón "Live Share" a convertirse en un "Estado de sesión".You will see the "Live Share" button transition to convey a "Session State". Consulte la información sobre el estado de sesión que aparece a continuación para saber cuál es el aspecto.See session state information below for what this looks like.

    Luego pasará automáticamente al archivo que actualmente está editando el anfitrión una vez que se una por completo.You'll then be automatically taken to the file the host is currently editing once the join is complete.

Salida de la sesión de colaboraciónLeave the collaboration session

Como invitado, puede salir de la sesión de colaboración sin finalizarla para los demás invitados. Para ello, simplemente cierre la ventana de VS Code.As a guest, you can leave the collaboration session without ending it for others by simply closing the VS Code window. Si prefiere mantener abierta la ventana, puede abrir la vista Explorador de Live Share o la pestaña personalizada Live Share y seleccionar el icono "Leave collaboration session" (Salir de la sesión de colaboración).If you'd prefer to keep the window open, you can open the Live Share Explorer view or the Live Share custom tab and select the "Leave collaboration session" icon.

Icono para salir de la sesión

Los archivos temporales se eliminar automáticamente, por lo que no es necesario hacer nada más.Any temp files are automatically cleaned up so no further action is needed.

¿Tiene problemas para participar en la sesión?Having issues with joining? Revise la solución de problemas.Check out troubleshooting.

Edición conjuntaCo-editing

Una vez que un invitado se une a una sesión de colaboración, todos los colaboradores podrán, de manera inmediata, ver las ediciones y selecciones de los demás en tiempo real.Once a guest has joined a collaboration session, all collaborators will immediately be able to see each other's edits and selections in real-time. Solo tiene que tomar un archivo del explorador de archivos y empezar a editarlo.All you need to do is pick a file from the file explorer and start editing. Tanto los anfitriones como los invitados verán cuando esté haciendo las ediciones y podrán contribuir, con lo que será más sencillo iterar y llegar a las soluciones.Both hosts and guests will see edits as you make them and can contribute themselves making it easy iterate and rapidly nail to down solutions.

Nota

Participar en una sesión de colaboración de solo lectura impide que los invitados puedan editar los archivos.Joining a read-only collaboration session prevents guests from being able to make edits to files. Un anfitrión puede habilitar el modo de solo lectura cuando comparten la sesión.A host can enable read-only mode when they share. Para saber si está participando en una sesión de solo lectura, un invitado debe mirar el estado de sesión.As a guest, you can tell if you have joined a read-only session by looking at your session state.

Captura de pantalla de una edición conjunta

Nota

La edición conjunta tiene limitaciones en ciertos lenguajes.Co-editing has limitations for certain languages. Consulte la información sobre compatibilidad con la plataforma para ver el estado de las características por lenguaje.See platform support for the state of features by language.

Más allá de los cursores y las ediciones, las selecciones que hace también son visibles para todos quienes participan en el mismo archivo.Beyond cursors and edits, selections you make are also visible to all participants in that same file. Esto facilita resaltar dónde puede haber problemas o transmitir ideas.This makes it easy to highlight where problems might exist or convey ideas.

Captura de pantalla que muestra elementos resaltados

Mejor aún: usted y otros participantes pueden ir a cualquier archivo en el proyecto compartido.Better yet, you and other participants can navigate to any file in the shared project. Puede editar en conjunto o de manera independiente, lo que significa que puede cambiar sin problemas entre la investigación, hacer pequeños ajustes y la edición totalmente colaborativa.You can either edit together or independently meaning you can seamlessly switch between investigation, making small tweaks and full collaborative editing.

Las ediciones resultantes se conservan en la máquina del anfitrión al guardar la sesión, por lo que no es necesario sincronizar, enviar cambios ni enviar archivos una vez que termine de editar.The resulting edits are persisted on the host's machine on save so there is no need to synchronize, push, or send files around once you're done editing. Las ediciones simplemente "están ahí".The edits are "just there."

Sugerencia de seguridad: Como todos los participantes pueden navegar y editar archivos de manera independiente, como anfitrión, es posible que quiera restringir los archivos a los que pueden acceder los invitados en el proyecto a través de un archivo .vsls.json.Security Tip: Given all participants can independently navigate and edit files, as a host, you may want to restrict which files guests are able to access in your project via a .vsls.json file. Como invitado, también es importante tener en cuenta que es posible que no vea determinados archivos como resultado de esta configuración.As a guest, it is also important to realize you may not see certain files as a result of these settings. Consulte Control de la visibilidad y el acceso de archivos para más información.See controlling file access and visibility for details.

Cambio de los comportamientos de las marcas de los participantesChanging participant flag behaviors

De manera predeterminada, Visual Studio Live Share muestra automáticamente una "marca" junto al cursor de un participante si mantiene el puntero sobre él, o cuando edite, resalte o mueva el cursor.By default, Visual Studio Live Share automatically displays a "flag" next to a participant's cursor on hover, or when they edit, highlight, or move their cursor. En algunos casos, quizás prefiera cambiar este comportamiento.In some cases, you may prefer to change this behavior.

Simplemente debe editar settings.json (Archivo > Preferencias > Configuración), agregar una de las líneas siguientes y, luego, reiniciar VS Code:Simply edit settings.json (File > Preferences > Settings), add one of the following lines, and then restart VS Code:

ParámetroSetting ComportamientoBehavior
"liveshare.nameTagVisibility":"Never" La marca solo es visible cuando mantiene el puntero sobre el cursor.The flag is only visible when you hover over the cursor.
"liveshare.nameTagVisibility":"Activity" Este es el valor predeterminado.This is the default. La marca es visible cuando mantiene el puntero sobre el cursor o si el participante edita, resalta o mueve el cursor.The flag is visible on hover or if the participant edits, highlights, or moves their cursor.
"liveshare.nameTagVisibility":"Always" La marca siempre está visible.The flag is always visible.

SeguimientoFollowing

En ocasiones necesitará explicar un problema o diseño que abarque varios archivos o ubicaciones en el código.Sometimes you need to explain a problem or design that spans multiple files or locations in code. En estos casos, puede ser útil seguir temporalmente a un compañero de trabajo mientras se mueve por el proyecto.In these situations, it can be useful to temporarily follow a colleague as they move throughout the project. Es por esto que, cuando se una a una sesión de colaboración, "seguirá" automáticamente al anfitrión.For this reason, when you join a collaboration session you will automatically "follow" the host. Cuando siga a alguien, el editor se mantendrá sincronizado con el archivo abierto actualmente de ese usuario y su posición de desplazamiento.When following someone, your editor will stay in sync with their currently open file and scroll position.

Nota

De manera predeterminada, Live Share también comparte los archivos abiertos externos a la carpeta compartida.By default, Live Share shares opened files external to the shared folder as well. Si quiere deshabilitar esta característica, actualice Live Share liveshare.shareExternalFiles a false en settings.json.If you want to disable this feature, update liveshare.shareExternalFiles Live Share to false in settings.json.

Para empezar a seguir a un participante (ya sea un anfitrión o un invitado), haga clic en su nombre en la lista de participantes en la pestaña personalizada o la vista Explorador de Live Share. El círculo junto a su nombre se rellenará para indicar que lo está siguiendo.To start following a participant (as either a host or guest), click on their name in the participants' list in the Live Share Explorer view or custom tab. The circle next to their name will fill in to indicate you are following them.

Opción de seguir en el viewlet de VS Code

De manera alternativa, puede hacer clic en el icono de anclaje que se encuentra en la esquina superior derecha del grupo de editores o presione Ctrl+Alt+F / Cmd+Alt+F.Alternatively, you can click the pin icon in the upper right of the editor group or press Ctrl+Alt+F / Cmd+Alt+F.

Anclaje de VS Code

Nota

Si hay más de una persona en la sesión de colaboración, tendrá que seleccionar al participante al que quiere seguir.If more than one other person is in the collaboration session, you'll be asked to select the participant you want to follow.

Captura de pantalla de la lista de colaboradores

Como el seguimiento está asociado a un grupo de editores, puede usar la vista dividida (o diseño de cuadrícula) para tener un grupo que siga a un participante y un grupo que no lo haga.Since following is tied to an editor group, you can use split view (or grid layout!) to have a group that is following a participant and a group that is not. Esto le permite seguir de manera pasiva a alguien mientras trabaja también en otra cosa.This allows you to passively follow someone while also working on something independently. Con un grupo de editores seleccionado, puede seleccionar a un participante en la lista de participantes para hacer que ese grupo lo siga.With an editor group selected, you can select a participant in the participants list to have that group follow them.

Anclaje de VS Code en la vista dividida

Para facilitar salir del "modo de seguimiento" y empezar a editar por su cuenta, dejará automáticamente de seguir participantes si ocurre alguna de estas situaciones:To make it easy to switch out of "follow mode" and start editing on your own, you'll automatically stop following if any of these occur:

  1. Empieza a editar el archivo actualmente activoYou start editing the currently active file
  2. Abre un archivo distintoYou open a different file
  3. Cierra el archivo actualmente activoYou close the currently active file

Además, puede dejar de seguir a alguien de manera explícita si hace clic en el icono de anclaje o presiona Ctrl+Alt+F / Cmd+Alt+F.Additionally, you can explicitly stop following someone by clicking the pin icon again or hitting Ctrl+Alt+F / Cmd+Alt+F.

Lista de participantesListing participants

Una forma rápida de ver a quienes están en la sesión de colaboración es mirar la lista de participantes en la pestaña personalizada o la vista Explorador de Live Share. Las vistas mostrarán todos los participantes de la sesión.A quick way to see who is in the collaboration session is to look at the participants list in the Live Share Explorer view or custom tab. The views will show all the participants in your session.

Captura de pantalla que muestra el icono de la barra de estado del usuario

Si hace clic en cualquiera de los participantes de esta lista, lo seguirá en el grupo de editores activo.Clicking on any participant in this list will follow them in your active editor group.

Como alternativa, puede presionar Ctrl+Mayús+P / Cmd+Mayús+P y seleccionar el comando "Live Share: List Participants" (Live Share: mostrar participantes) o hacer clic en el elemento de la barra de estado que muestra el número de participantes en la sesión.Alternatively, you can hit Ctrl+Shift+P / Cmd+Shift+P and select the "Live Share: List Participants" command or click on the status bar item that shows the number of participants in your session.

Captura de pantalla que muestra el icono de la barra de estado del usuario

De ese modo, aparecerá una lista de todos los participantes de la sesión.A list of all participants in the session will then appear. A diferencia de lo que ocurre cuando se hace clic en el icono de anclaje, esta lista aparece incluso si hay solo una persona más en la sesión junto con usted, por lo que siempre podrá ver rápidamente dónde se ubica alguien más.Unlike clicking the pin icon, this list appears even if there is only one other person in the session with you so you can always quickly see where someone else is located. Para su comodidad, del mismo modo que con el icono de anclaje, puede elegir uno de los participantes de la lista para seguirlo.For convenience purposes, like the pin icon, you can then pick one of the participants from the list to follow them. Si prefiere salir, presione Escape.Press escape if you'd like to exit instead.

Atracción de la atención de los participantesFocusing

En algunas ocasiones puede que quiera que todos quienes participan en una sesión de colaboración vean lo que está haciendo.Occasionally you may want everyone in a collaboration session to come and take a look at something you are doing. Live Share le pide solicitar que todo el mundo "centre" su atención en usted con una notificación que les facilita la tarea de seguirle.Live Share lets you ask that everyone "focus" their attention on you with a notification that makes it easy for them to follow you back.

Abra la pestaña personalizada Live Share en la barra de actividades de VS Code o la vista Explorador de Live Share y seleccione el icono "Atraer la atención de los participantes".Open the Live Share custom tab in the VS Code activity bar or the Live Share Explorer view, and select the "Focus participants" icon.

Icono para atraer la atención de los participantes del viewlet

Una vez que ejecute el comando, todos los participantes de la sesión de colaboración recibirán una notificación de que solicita su atención.Once you run the command, everyone in the collaboration session will then get a notification that you've requested their attention.

Notificación del sistema sobre atraer la atención de los participantes

De ese modo, ellos pueden simplemente hacer clic en "Seguir" directo en la notificación cuando estén listos para centrar su atención en usted.They can then just click "Follow" right from the notification when they're ready to put their focus on you.

Depuración conjuntaCo-debugging

La característica de depuración colaborativa de Visual Studio Live Share es una manera única y eficaz de depurar un problema.Visual Studio Live Share's collaborative debugging feature is a powerful and unique way to debug an issue. Más allá de permitir una experiencia de colaboración para solucionar problemas, también le brinda a usted y a otros participantes de la sesión la capacidad de investigar los problemas que puedan ser específicos del entorno al proporcionar una sesión de depuración compartida en la máquina del anfitrión.Beyond enabling a collaborative experience to troubleshoot problems, it also gives you and other participants in your session the ability to investigate issues that may be environment specific by providing a shared debugging session on the host's machine.

Sugerencia de seguridad: Como todos los participantes pueden navegar y editar archivos de manera independiente, como anfitrión, es posible que quiera restringir los archivos a los que pueden acceder los invitados en el proyecto a través de un archivo .vsls.json.Security Tip: Given all participants can independently navigate and edit files, as a host, you may want to restrict which files guests are able to access in your project via a .vsls.json file. También debe tener en cuenta que el acceso a la consola/REPL significa que los participantes pueden ejecutar comandos en su máquina, por lo que solo debe depurar en conjunto con personas de confianza.You should also be aware that Console/REPL access means that participants can execute commands on your machine so you should only co-debug with those you trust. Como invitado, también es importante tener en cuenta que es posible que no pueda seguir al depurador, porque entra en ciertos archivos restringidos como resultado de esta configuración.As a guest, it is also important to realize you may not be able to follow the debugger as it steps into certain files restricted files as a result of these settings. Consulte Control de la visibilidad y el acceso de archivos para más información.See controlling file access and visibility for details.

Usarlo es simple.Using it is simple.

  1. Asegúrese de que tanto el anfitrión como todos los invitados tengan instalada la extensión de depuración correspondiente.Be sure both the host and all guests have the appropriate debugging extension installed. (No siempre es técnicamente necesaria, pero es una buena idea hacerlo).(Technically this is not always necessary, but it is generally a good idea.)

  2. Como anfitrión, si todavía no está configurado para el proyecto, debe configurar launch.json para depurar la aplicación desde VS Code como lo haría normalmente.As the host, if not already set up for the project, you should configure launch.json to debug the application from VS Code as you would normally. No se requiere ninguna configuración especial.No special setup is required.

  3. A continuación, el anfitrión puede empezar a depurar con el botón de la pestaña de depuración, tal como lo haría normalmente.Next, the host can start debugging using the button in the debug tab as normal.

    Botón de depuración de VS Code

    Sugerencia

    También puede participar en las sesiones de depuración de Visual Studio desde VS Code y viceversa.You can also participate in Visual Studio debugging sessions from VS Code and vice versa! Consulte las instrucciones de Visual Studio para más información sobre la depuración conjunta.Check out the Visual Studio instructions on co-debugging for more information.

Una vez que el depurador se asocia en el lado del anfitrión, también se ajustan automáticamente todos los invitados.Once the debugger attaches on the host's side, all guests are also automatically attached. Mientras hay una "sesión" de depuración ejecutándose en la máquina del anfitrión, todos los participantes se conectan a ella y tienen su propia vista.While there is one debugging "session" running on the host's machine, all participants are connected to it and have their own view.

Depurador de VS Code asociado

Cualquier persona puede desplazarse por el proceso de depuración, lo que permite cambiar sin problemas entre los colaboradores sin tener que negociar el control.Anyone can step through the debugging process which enables seamless switching between collaborators without having to negotiate control.

Nota

Consulte la información sobre compatibilidad con la plataforma para ver el estado de las características de depuración por lenguaje o plataforma.See platform support for the state of debugging features by language or platform.

Cada colaborador puede investigar distintas variables, saltar a distintos archivos en la pila de llamadas, inspeccionar las variables e incluso agregar o quitar puntos de interrupción.Each collaborator can investigate different variables, jump to different files in the call stack, inspect variables, and even add or remove breakpoints. Luego, las características de edición conjunta permiten que cada orador participante haga un seguimiento de dónde se encuentran ubicados los demás para brindar la capacidad única de cambiar sin complicaciones entre los distintos aspectos del problema que se investigan en simultáneo y la depuración colaborativa.Co-editing features then allow each participant orator to track where the others are located to provide the unique ability to seamlessly switch between concurrently investigating different aspects of the problem and collaboratively debugging.

Nota

Mientras esté en una sesión de colaboración de solo lectura, un invitado no podrá desplazarse por el proceso de depuración.While in a read-only collaboration session, a guest will not be able to step through the debugging process. Sin embargo, sí puede agregar o quitar puntos de interrupción e inspeccionar variables.They can however, still add or remove breakpoints, and inspect variables.

Animación de la depuración simultánea

Cambio cuando VS Code se une a las sesiones de depuraciónChange when VS Code joins debugging sessions

De manera predeterminada, como invitado, se lo asociará automáticamente a las sesiones de depuración cuando el anfitrión las comparta.By default, as a guest, you'll be automatically attached to debugging sessions when they are shared by the host. Sin embargo, en algunos casos, puede considerar que este comportamiento es problemático.However, in some cases, you may find this behavior disruptive. Afortunadamente, puede cambiarlo de la siguiente manera:Fortunately, you can change it as follows:

Simplemente debe editar settings.json (Archivo > Preferencias > Configuración), agregar una de las líneas siguientes y, luego, reiniciar VS Code:Simply edit settings.json (File > Preferences > Settings), add one of the following lines, and then restart VS Code:

ParámetroSetting ComportamientoBehavior
"liveshare.joinDebugSessionOption":"Automatic" El valor predeterminado.The default. Como invitado, participará automáticamente en cualquier sesión de depuración que inicie el anfitrión.As a guest, you'll automatically join any shared debugging session the host starts.
"liveshare.joinDebugSessionOption":"Prompt" Como invitado, se le preguntará si quiere participar en una sesión de depuración compartida cuando la inicie el anfitrión.As a guest, you are prompted as to whether you want to join a shared debugging session when it is started by the host.
"liveshare.joinDebugSessionOption":"Manual" Como invitado, deberá participar manualmente en cualquier sesión de depuración.As a guest, you'll need to manually join any debugging sessions. Consulte Desasociación y nueva asociación.See detaching and reattaching.

Desasociación y nueva asociaciónDetaching and reattaching

Es posible que un invitado quiera detener temporalmente la depuración.As a guest, you may wish to stop debugging temporarily. Afortunadamente, puede simplemente hacer clic en el icono "Detener" de la barra de herramientas de depuración para desasociar el depurador sin afectar al anfitrión ni a otros invitados.Fortunately, you can simply click the "stop" icon in the debug toolbar to detach the debugger without affecting the host or other guests.

Botón de detención del depurador de VS

Si actualizó la configuración y ya no se asocia de manera automática o si simplemente quiere volver a asociarse más adelante, puede presionar Ctrl+Mayús+P / Cmd+Mayús+P o hacer clic en el elemento de estado de la barra de estado y seleccionar "Attach to a Shared Debugging Session"(Asociar a una sesión de depuración compartida).If you've updated settings so you no longer auto-attach or if you simply want to reattach later, you can do so by pressing Ctrl+Shift+P / Cmd+Shift+P or clicking on the session state status bar item and selecting "Attach to a Shared Debugging Session".

Asociar depurador de VS Code

Uso compartido de la aplicación en ejecución en un exploradorSharing the running application in a browser

Visual Studio Code no tiene el concepto de un "puerto de aplicación web" conocido como Visual Studio para tipos de proyecto como ASP.NET.Visual Studio Code does not have the concept of a known "web application port" like Visual Studio for project types such as ASP.NET. Sin embargo, si va a participar en una sesión de colaboración desde un anfitrión de Visual Studio, puede ver automáticamente que el explorador predeterminado aparece cuando se inicia la depuración y que luego se conecta automáticamente a las aplicaciones en ejecución del anfitrión.However, if you are joining a collaboration session from a Visual Studio host, you may automatically see your default browser appear when debugging starts that is then automatically connected to the host's running applications. Consulte Características de Visual Studio para más detalles.See Visual Studio features for more details.

Como anfitrión, puede lograr algo similar si comparte manualmente la aplicación u otros puntos de conexión, como los servicios RESTful, a través de la característica "Share Local Server" (Compartir servidor local).As a host, you can achieve something similar by manually sharing the application or other endpoints like RESTful services using the "Share Local Server" feature. Los invitados de Visual Studio y VS Code entonces pueden abrir un explorador en el mismo puerto localhost para ver la aplicación en ejecución.Visual Studio and VS Code guests can then open a browser on the same localhost port to see the running application. Consulte Uso compartido de un servidor para más detalles.See share a server for more details.

Uso compartido de un servidorShare a server

De vez en cuando, como anfitrión de la sesión de colaboración, puede darse el caso de que quiera compartir una aplicación web u otro servicio o servidor en ejecución local con los invitados.From time to time, as a collaboration session host, you may find that you want to share a web application or other locally running servers or services with guests. Esto puede ir desde otros puntos de conexión de RESTful a bases de datos y otros servidores.This can range from other RESTful end-points to databases and other servers. Visual Studio Live Share le permite especificar un número de puerto local, darle un nombre si así lo quiere y compartirlo con todos los invitados.Visual Studio Live Share lets you specify a local port number, optionally give it a name, and then share it with all guests.

A continuación, los usuarios podrán acceder al servidor que compartió en ese puerto desde su propia máquina local exactamente en el mismo puerto.The guests will then be able to access the server you shared on that port from their own local machine on the exact same port. Por ejemplo, si compartió un servidor web en ejecución en el puerto 3000, el invitado puede acceder a ese mismo servidor web en ejecución en su propia máquina en http://localhost:3000.For example, if you shared a web server running on port 3000, the guest can access that same running web server on their own machine at http://localhost:3000! Esto se logra a través de un túnel SSH o SSL entre el anfitrión y los invitados y se autentica a través del servicio, por lo que puede estar seguro de que solo quienes participen de la sesión de colaboración tienen acceso.This is accomplished via a secure SSH or SSL tunnel between the host and guests and authenticated via the service so you can be sure that only those in the collaboration session have access.

Sugerencia de seguridad: Como anfitrión, debe ser muy selectivo con los puertos que comparte con los invitados y limitarse a los puertos de aplicación (en lugar de compartir un puerto de sistema).Security Tip: As a host, you should be very selective with the ports you share with guests and stick to application ports (rather than sharing a system port). En el caso de los invitados, los puertos compartidos se comportarán exactamente igual que si el servidor o servicio se estuviese ejecutando en su propia máquina.For guests, shared ports will behave exactly like they would if the server/service was running on their own machine. Esto es muy útil, pero podría ser también arriesgado si es que se comparte el puerto incorrecto.This is very useful, but if the wrong port is shared can also be risky.

Por motivos de seguridad, solo los servidores que se ejecutan en los puertos que especifica estarán disponibles a los demás invitados.For security purposes, only servers running on ports you specify are available to other guests. Afortunadamente, es fácil agregar uno como el anfitrión de la sesión de colaboración.Fortunately, it's easy to add one as the collaboration session host. Esta es la manera de hacerlo:Here's how:

  1. Abra la pestaña personalizada Live Share en la barra de actividades de VS Code o la vista Explorador de Live Share y seleccione la entrada "Share server…" (Compartir servidor) o haga clic en el icono.Open the Live Share custom tab in the VS Code activity bar or the Live Share Explorer view, and select the "Share server..." entry or click the icon.

    Compartir servidor local de VS Code

  2. Escriba el número de puerto en el que se ejecuta el servidor y, si quiere, un nombre.Enter the port number the server is running on and optionally a name.

    Captura de pantalla de la solicitud del número de puerto

Ya está.That's it! El servidor en el puerto que especificó ahora se asignará al localhost de cada invitado en el mismo puerto (a menos que ya esté ocupado).The server on the port you specified will now be mapped to each guest's localhost on the same port (unless that port was already occupied)!

Si el puerto ya está en uso en la máquina del invitado, se seleccionará otro automáticamente.If the port is already in use on the guest's machine, a different one is automatically selected. Por fortuna, como invitado puede ver una lista de los puertos actualmente compartidos (por nombre si se especificó) en la pestaña personalizada o la vista Explorador de Live Share en la barra de actividades de VS Code y ver debajo de la lista de servidores compartidos.Fortunately, as a guest, you can see a list of currently shared ports (by name if specified) in the Live Share Explorer view or custom tab in the VS Code activity bar, and look under the shared servers list. Si se selecciona una entrada, ese servidor se abre en el explorador.Selecting an entry opens that server in your browser. También puede hacer clic con el botón derecho y seleccionar la opción para copiar el vínculo al servidor en el Portapapeles.You can also right click and select the option to copy the link to the server to the clipboard.

Servidor local de acceso de VS Code

Tenga en cuenta que los invitados no pueden controlar qué puertos de la máquina del anfitrión se comparten por motivos de seguridad.Note that guests cannot control which ports on the host's machine are shared for security reasons.

Para dejar de compartir un servidor local como el anfitrión, mantenga el puntero sobre la entrada del servidor en la lista de los servidores compartidos en la pestaña personalizada o la vista Explorador de Live Share y haga clic en el icono "Unshare server" (Dejar de compartir el servidor).To stop sharing a local server as the host, hover over the server entry in the shared servers list in the Live Share Explorer view or custom tab, and click the "Unshare server" icon.

Dejar de compartir el servidor en VS Code

Uso compartido de un terminalShare a terminal

El desarrollo moderno hace un uso frecuente de una amplia gama de herramientas de línea de comandos.Modern development makes frequent use of a wide array of command line tools. Afortunadamente, como anfitrión, Live Share le permite, de forma opcional, "compartir un terminal" con los invitados.Fortunately, Live Share allows you, as a host, to optionally "share a terminal" with guests. El terminal compartido puede ser de solo lectura o totalmente colaborativo, para que tanto usted como los invitados puedan ejecutar comandos y ver los resultados.The shared terminal can be read-only or fully collaborative so both you and the guests can run commands and see the results. Puede dar a los invitados visibilidad sobre la salida del terminal o permitirles obtener experiencias prácticas y ejecutar pruebas, compilaciones o incluso evaluar la prioridades de los problemas específicos del entorno que solo aparecen en su máquina.You can to give guests visibility to terminal output or let them get hands-on and run tests, builds, or even triage environment-specific problems that only happen on your machine.

Sin embargo, los terminales no se comparten de manera predeterminada, porque dan a los invitados al menos acceso de solo lectura a la salida de los comandos que usted ejecuta (si es que no la capacidad de ejecutar los comandos mismos).However, terminals are not shared by default since they give guests at least read-only access to the output of commands you run (if not the ability to run commands themselves). De este modo, puede ejecutar libremente los comandos en los terminales locales sin riesgo y solo compartirlos cuando de verdad tenga que hacerlo.This way you can freely run commands in local terminals without risk and only share when actually need to do so. Además, solo los anfitriones pueden iniciar los terminales compartidos para impedir que los invitados inicien uno y hagan algo inesperado o sin supervisión.In addition, only hosts can start shared terminals to prevent guests from starting one up and doing something you are not expecting or watching.

Como anfitrión, para compartir un terminal puede abrir la pestaña personalizada Live Share en la barra de actividades de VS Code o la vista Explorador de Live Share y seleccionar la entrada "Share server…" (Compartir servidor) o hacer clic en el icono.As a host, you can share a terminal by opening the Live Share custom tab in the VS Code activity bar or the Live Share Explorer view, and selecting the "Share server..." entry or clicking the icon.

Uso compartido del terminal en VS Code

En este momento, puede seleccionar un terminal de solo lectura o de lectura y escritura en el menú.At this point, you can select a read-only or read/write terminal from the menu. Si el terminal es de lectura/escritura, todos los participantes pueden escribir en el terminal, incluido el anfitrión, lo que permite intervenir fácilmente si un invitado hace algo que no le gusta.When the terminal is read/write, everyone can type in the terminal including the host which makes it easy to intervene if a guest is doing something you do not like. Sin embargo, para estar seguros, debería darle acceso de lectura/escritura a los invitados solo cuando sabe que realmente lo necesitan y limitarse a los terminales de solo lectura en escenarios donde quiere que un invitado solo vea la salida de los comandos que ejecuta.However, to be safe, you should only give read/write access to guests when you know they actually need it and stick with read-only terminals for scenarios where you just want the guest to see the output of any commands you run. Tenga en cuenta que el acceso de lectura y escritura proporciona al invitado el mismo acceso al terminal que usted, por lo que podrá ejecutar cualquier comando en el equipo que pueda ejecutar usted.Keep in mind that read/write access gives the guest the same access to your terminal that you have, and they can run any command on your computer that you can.

Nota

Si la sesión de colaboración está en modo de solo lectura, el anfitrión solo puede compartir los terminales de solo lectura.If the collaboration session is in read-only mode, only read-only terminals can be shared by the host.

Selección de solo lectura o de lectura/escritura

Una vez que haya seleccionado el tipo de terminal compartido que quiere iniciar, aparecerá un terminal compartido nuevo en la pestaña de terminales de VS Code.Once you've selected the kind of shared terminal you want to start, a new shared terminal will appear under VS Code's terminals tab.

Terminal compartido en ejecución

Si se comparten varios terminales o si su atención está en otra pestaña, puede atraer la atención a un terminal específico si selecciona la entrada en la lista de terminales compartidos.If multiple terminals are shared, or your focus is in a different tab, you can bring focus to a specific terminal by selecting the entry in the shared terminals list.

Centrar la atención en un terminal compartido

Para finalizar la sesión del terminal, solo debe escribir exit (salir), cerrar la ventana del terminal o hacer clic en el icono "Unshare terminal" (Dejar de compartir el terminal) en la pestaña personalizada o la vista Explorador de Live Share y se desconectará a cada uno de los participantes.To end your terminal session, simply type exit, close the terminal window, or click the "Unshare terminal" icon in the Live Share Explorer view or custom tab and everyone will be disconnected.

Estados de sesiónSession states

Una vez que inicie una sesión de colaboración o que se una a ella y tenga acceso al contenido compartido, los elementos de la barra de estado de Visual Studio Live Share actualizarán su apariencia para reflejar el estado de la sesión de colaboración activa.After you have started or joined collaboration session and have access to shared content, the Visual Studio Live Share status bar items update their appearance to reflect the state of the active collaboration session.

Estos son los estados que verá habitualmente:The following are the states you will typically see:

EstadoState Barra de estadoStatus Bar DescripciónDescription
InactivoInactive Estado de VS Code: inactivo No hay ninguna sesión de colaboración activa y no se comparte nada.No active collaboration session and nothing is shared.
Anfitrión: Uso compartido en cursoHost: Sharing In-Progress Estado de VS Code: uso compartido en curso Se inicia una sesión de colaboración y pronto se empezará a compartir contenido.A collaboration session is starting and content sharing will begin shortly.
Anfitrión: Uso compartido de recursosHost: Sharing Estado de VS Code: uso compartido activoVS Code status: sharing active Hay una sesión de colaboración activa y se comparte contenido.A collaboration session is active and content is shared.
Anfitrión: Uso compartido de solo lecturaHost: Sharing Read-only Estado de VS Code: uso compartido de solo lectura Se comparte una sesión de colaboración de solo lectura.Sharing a read-only collaboration session.
Invitado: Participación en la sesiónGuest: Joining Session Estado de VS: participación Participación en una sesión de colaboración existente.Joining an existing collaboration session.
Invitado: participandoGuest: Joined Estado de VS Code: participando Se conectó y está participando en una sesión de colaboración activa y recibe contenido compartido.Joined and connected to an active collaboration session and receiving shared content.
Invitado: Participando en solo lecturaGuest: Joined Read-only Estado de VS Code: participando en solo lectura Se conectó y está participando en una sesión de colaboración de solo lectura activa.Joined and connected to an active read-only collaboration session.

Limitaciones de los invitadosGuest limitations

Si bien actualmente los invitados pueden encontrarse con algunas limitaciones al usar las características ya descritas, los anfitriones de la sesión de colaboración conservan toda la funcionalidad de su herramienta preferida.While there are currently some shortcomings guests will experience while using the features described above, collaboration session hosts retain the complete functionality of their tool of choice. Para obtener más información, vea las secciones siguientes:See the following for more information:

Pasos siguientesNext steps

Consulte estos artículos adicionales para obtener más información.Check out these additional articles for more information.

¿Tiene algún problema?Having problems? Consulte la solución de problemas o envíe sus comentarios.See troubleshooting or provide feedback.