Uso de Live Share para colaborar en Visual Studio Code

¿Está listo para empezar a colaborar con Live Share en Visual Studio Code? En este artículo, le mostraremos cómo configurar una sesión de colaboración en Visual Studio Code mediante la extensión Live Share.

Tenga en cuenta que las actividades de colaboración que se describen aquí constan de un único anfitrión de la sesión de colaboración y uno o varios invitados. El anfitrión es la persona que inició la sesión de colaboración y todo aquel que se una es un invitado.

¿Busca un resumen abreviado? Consulte los inicios rápidos sobre uso compartido o unión.

Sugerencia

¿Sabía que puede unirse a su propia sesión de colaboración? De esta forma, puede probar Live Share por su cuenta o poner en marcha una instancia de Visual Studio o Visual Studio Code y conectarse a ella de forma remota. Incluso puede usar la misma identidad en ambas instancias. ¡Compruébelo!

Requisitos previos

Antes de empezar, deberá tener una versión compatible de Visual Studio Code que cumpla los requisitos principales de Live Share.

Deberá ejecutar Visual Studio Code (1.22.0 o posterior) en uno de los siguientes sistemas operativos:

  • Windows: 7, 8.1 o 10.

  • macOS: Sierra (10.12) y versiones posteriores. Debido a los requisitos de .NET Core 2.0, no se admiten actualmente El Capitan (10.11) y versiones anteriores.

  • Linux: Ubuntu Desktop 16.04 y versiones posteriores de 64 bits, Fedora Workstation 27 y versiones posteriores o CentOS 7.

Instalación del paquete de la extensión Live Share

Al descargar y usar Visual Studio Live Share, acepte los términos de licencia y la declaración de privacidad. Si surge algún problema, consulte la solución de problemas.

  1. Instale Visual Studio Code.
  2. Descargue e instale el paquete de la extensión Visual Studio Live Share desde Marketplace.
  3. Vuelva a cargar Visual Studio Code.
  4. Espere a que las dependencias se descarguen e instalen. (Consulte la barra de estado).
    Captura de pantalla que muestra la barra de estado durante la descarga.
  5. Solo Linux: si ve una notificación sobre la instalación de bibliotecas que faltan:
    1. Seleccione Instalar en la notificación.
    2. Escriba la contraseña de administrador (sudo) cuando se le solicite.
    3. Reinicie Visual Studio Code cuando finalice la instalación.

Botón para descargar Live Share.

Pasos de instalación de Linux

Linux es un entorno muy variable. Dado el número de entornos de escritorio y distribuciones, la instalación de Live Share puede ser complicada. Si usa versiones compatibles de Ubuntu Desktop (16.04+), Fedora Workstation (27+), o CentOS 7 y solo emplea distribuciones oficiales de Visual Studio Code, el proceso será sencillo. Si usa una configuración no estándar o una distribución de nivel inferior, puede que se encuentre con complicaciones. Para más información, consulte Detalles de la instalación de Linux.

Instalación de los requisitos previos de Linux

Algunas distribuciones de Linux carecen de bibliotecas que Live Share necesita. De forma predeterminada, Live Share intenta detectar e instalar los requisitos previos de Linux. Cuando Live Share encuentre un problema que puede estar relacionado con bibliotecas que faltan, verá una notificación que le pide que las instale:

Captura de pantalla de la notificación de bibliotecas de Linux que faltan.

Al seleccionar Instalar, se abrirá una ventana de terminal. Escriba la contraseña de administrador (sudo) para continuar. Si la instalación finaliza correctamente, reinicie Visual Studio Code. Y con esto, ya debería estar todo listo. También puede consultar las sugerencias de distribución para conocer otras indicaciones y soluciones alternativas.

Si ve un mensaje que indica que el script no es compatible con la distribución, consulte Sugerencias para distribuciones admitidas por la comunidad para ver la información que la comunidad ha compartido.

Si no quiere que Visual Studio Code ejecute el comando sin que usted intervenga, también puede volver a ejecutar la versión más reciente de este script en cualquier momento ejecutando este comando desde una ventana de terminal:

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

Integración del explorador de Linux

Por lo general, Visual Studio Live Share no necesita pasos de instalación adicionales para permitir la integración del explorador en Linux.

En algunas distribuciones poco habituales, es posible que reciba una notificación de que se necesita su contraseña de administración (sudo) para finalizar la instalación. Aparecerá una ventana de terminal para indicar dónde se instalará el iniciador del explorador. Para cerrar la ventana de terminal, escriba la contraseña cuando se le solicite y seleccione Entrar cuando la instalación finalice.

Para información sobre por qué se necesita la contraseña y dónde coloca Live Share los archivos, consulte Integración del explorador de Linux. Aunque no consiga que funcione la integración con el explorador, de todos modos, puede unirse manualmente a las sesiones de colaboración.

Inicio de sesión en Live Share

Para colaborar, deberá iniciar sesión en Visual Studio Live Share para que todos sepan quién es usted. Se trata de una medida de seguridad y no implica que se le agregue a actividades de marketing ni a otras actividades de investigación. Puede iniciar sesión con una cuenta personal de Microsoft (por ejemplo, @outlook.com), una cuenta de trabajo o educativa con el respaldo de Microsoft (Azure Active Directory) o una cuenta de GitHub. Es fácil iniciar sesión.

Seleccione Live Share en la barra de estado o use la combinación de teclas Ctrl+Mayús+P o Cmd+Mayús+P y, luego, elija Live Share: Sign In With Browser (Live Share: Iniciar sesión con el explorador).

Captura de pantalla que muestra el botón de inicio de sesión de Visual Studio Code.

Aparecerá una notificación para pedirle que inicie sesión con el explorador web. Si hace clic en launch sign in (comenzar inicio de sesión), se abrirá un explorador que puede usar para finalizar el proceso de inicio de sesión. Cuando termine, simplemente cierre el explorador.

Captura de pantalla que muestra la notificación que solicita el inicio de sesión con el explorador web.

Nota

Usuarios de Linux: puede que se le pida que escriba un código de usuario si usa una versión antigua de Live Share (versión 0.3.295 o inferior). Actualice a la versión más reciente de la extensión o, para ver el código, seleccione ¿Tiene problemas? después de iniciar sesión. Para más información, consulte Inicio de sesión con un código de usuario.

Sugerencia avanzada: Las opciones liveshare.account y liveshare.accountProvider le permiten seleccionar la cuenta usada para el inicio de sesión automático si ha almacenado en caché las credenciales de varias cuentas. Por ejemplo, imagine que trabaja en dos proyectos y quiere iniciar sesión en ellos con identidades diferentes. En la configuración del área de trabajo de Visual Studio Code, puede establecer liveshare.account en una dirección de correo electrónico diferente en cada directorio del proyecto. Así, iniciará sesión automáticamente en los proyectos con la cuenta correcta. Puede establecer la opción liveshare.accountProvider en "microsoft" o "github" si usa la misma dirección de correo electrónico con varios proveedores.

Si Visual Studio Code no acepta su inicio de sesión después de finalizar el proceso en el explorador, consulte Inicio de sesión con un código de usuario. En caso contrario, revise Solución de problemas para ver más sugerencias.

Inicio de sesión con un código de usuario

Si tiene problemas para que Visual Studio Code acepte un inicio de sesión completado, puede escribir un código de usuario en su lugar.

  1. Seleccione Ctrl+Mayús+P o Cmd+Mayús+P y, luego, ejecute el comando Live Share: Sign in with user code (Live Share: Iniciar sesión con un código de usuario).

  2. Se abrirá un explorador. Úselo para completar el proceso de inicio de sesión:

    Nota

    Si un explorador no se abre automáticamente, vaya a https://insiders.liveshare.vsengsaas.visualstudio.com/auth/login e inicie sesión.

  3. Después, seleccione Having trouble? Click here for user code directions (¿Tiene problemas? Haga clic aquí para ver las instrucciones relativas al código de usuario).

    Captura de pantalla que muestra un código de usuario en una ventana del explorador.

  4. Copie el código de usuario.

  5. Péguelo en el campo de entrada que apareció cuando ejecutó el comando. Seleccione Entrar para finalizar el proceso de inicio de sesión.

    Captura de pantalla que muestra el cuadro de entrada del código de usuario.

Búsqueda de comandos de Live Share

En el viewlet de Live Share

Después de instalar Visual Studio Live Share, aparecerá una pestaña personalizada en la barra de actividad de Visual Studio Code. En esta pestaña, puede acceder a todas las funciones de colaboración de Live Share. Cuando se una a una sesión de colaboración o la comparta, también aparecerá una vista en la pestaña Explorador que le permite acceder a estas funciones.

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

Con estas vistas, puede ver la ubicación de un participante en el código compartido, seleccionar participantes para seguirlos, atraer la atención de los participantes, acceder a servidores y terminales compartidos, etc.

En el menú de comandos con ámbito

Todas las funciones de Visual Studio Live Share también están disponibles en la paleta de comandos de Visual Studio Code. Para acceder a la paleta de comandos, seleccione Ctrl+Mayús+P / Cmd+Mayús+P o F1. Para encontrar una lista completa de comandos, escriba live share.

Dado que esta lista puede ser larga, puede ser más fácil usar un menú de comandos limitado desde la barra de estado. Al seleccionar el botón de inicio de sesión o de estado de sesión en la barra de estado, se abrirá una lista contextualizada de los comandos disponibles para su uso:

Captura de pantalla que muestra el botón de estado de sesión de Visual Studio Code.

Inicio y detención de una sesión

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.

  1. Inicio de sesión

    Después de instalar la extensión Live Share, vuelva a cargarla y espere a que se instalen las dependencias, e inicie sesión para que otros colaboradores sepan quién es usted. Para más información, consulte Inicio de sesión.

  2. Abrir una carpeta

    Use el flujo de trabajo normal para abrir una carpeta, un proyecto o una solución que quiera compartir con sus invitados.

  3. [Opcional] Actualizar los archivos ocultos o excluidos

    De forma 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. Ocultar un archivo evita que aparezca en el árbol de archivos del invitado. Al excluir un archivo se aplica una regla más estricta. La exclusión de un archivo impide que Live Share lo abra para un invitado en situaciones como Ir a definición o cuando se entra en el archivo para depurarlo paso a paso por instrucciones o se "sigue". Para ocultar o excluir archivos, agregue un archivo .vsls.json con la configuración adecuada al proyecto. Para más información, consulte Control del acceso y la visibilidad de los archivos.

  4. Iniciar una sesión de colaboración

    Para iniciar una sesión, seleccione Live Share en la barra de estado o use la combinación de teclas Ctrl+Mayús+P o Cmd+Mayús+P y, luego, elija Live Share: Start a collaboration session (Share) (Live Share: Iniciar una sesión de colaboración [compartir]).

    Captura de pantalla que muestra el botón de Live Share.

    Nota

    La primera vez que comparta la sesión, es posible que el software del firewall de escritorio le pida que permita que el agente de Live Share abra un puerto. La apertura de un puerto es opcional. Sin embargo, permite un modo directo protegido para mejorar el rendimiento cuando la persona con la que trabaja está en la misma red que usted. Para más información, consulte Cambio del modo de conexión.

    Un vínculo de invitación se copiará automáticamente en el Portapapeles. 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 las carpetas.

    También verá cómo el elemento de la barra de estado Live Share cambia para representar el estado de sesión. Para ver su aspecto, consulte la información de estado de sesión más adelante en este artículo.

    Si necesita volver a obtener el vínculo de invitación después de que ha empezado a compartir, en la barra de estado, seleccione el elemento de estado de sesión y elija Invite Others (Copy Link) (Invitar a otros [copiar vínculo]).

  5. [Opcional] Habilitar el modo de solo lectura

    Después de iniciar la sesión de colaboración, puede establecerla como de solo lectura para evitar que los invitados modifiquen el código que está compartiendo.

    Después de compartirla, recibirá una notificación de que el vínculo de invitación se ha copiado en el Portapapeles. Luego, puede seleccionar la opción de solo lectura para la sesión:

    Captura de pantalla que muestra el botón Hacer de solo lectura.

  6. Enviar el vínculo a alguien

    Envíe el vínculo por correo electrónico, Slack, Skype u otras plataformas a los usuarios que quiera invitar. Dado el nivel de acceso que las sesiones de Live Share pueden proporcionar a los invitados, solo se deben compartir con usuarios de confianza, y piense detenidamente en las implicaciones de lo que va a compartir.

    Sugerencia de seguridad: ¿Quiere conocer las implicaciones que algunas de las características de Live Share tienen para la seguridad? Consulte el artículo sobre seguridad.

    Los usuarios que invite pueden tener preguntas. En el artículo Inicio rápido: Unirse a la primera sesión de colaboración se proporciona información sobre cómo participar como invitado.

  7. [Opcional] Aprobar al invitado

    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. Esta notificación le ofrece la opción de eliminarlos de la sesión. También puede optar por exigir la aprobación explícita de cualquiera que se una.

    Para habilitar esta aprobación, agregue el código siguiente a settings.json:

    "liveshare.guestApprovalRequired": true
    

    Cuando active esta configuración, recibirá una notificación para que apruebe a los invitados antes de que puedan unirse.

    Captura de pantalla que muestra una solicitud de aprobación de unión a Visual Studio Code.

    Para más información sobre las consideraciones de seguridad de las invitaciones, consulte Invitaciones y acceso de unión.

Ya está.

Detención de la sesión de colaboración

Como anfitrión, puede dejar de compartir completamente y finalizar la sesión de colaboración en cualquier momento. Para ello, abra la vista de Live Share en las pestañas Explorador o VS Live Share y seleccione el botón Stop collaboration session (Detener sesión de colaboración):

Captura de pantalla que muestra el botón Stop collaboration session (Detener sesión de colaboración).

Todos los invitados recibirán una notificación de que finalizó la sesión. Cuando la sesión haya terminado, los invitados no podrán acceder al contenido. Los archivos temporales se limpiarán automáticamente.

¿Tiene problemas para compartir? Consulte el artículo Solución de problemas.

Unión a una sesión y salida de esta

Después de descargar e instalar Visual Studio Live Share, los invitados solo deben realizar un par de pasos para unirse a una sesión de colaboración hospedada. Hay dos maneras de unirse: a través del explorador y manualmente.

Sugerencia de seguridad: Los invitados que se unen a una sesión de colaboración deben comprender que los anfitriones podrían restringir su acceso a determinados archivos o características. ¿Quiere comprender las implicaciones que las características y opciones de configuración de Live Share tienen para la seguridad? Consulte el artículo sobre seguridad.

Unirse a través del explorador

La manera más fácil de unirse a una sesión de colaboración es simplemente abrir el vínculo de invitación en un explorador web. Esto es lo que puede esperar:

  1. Inicio de sesión

    Después de instalar la extensión Live Share, volver a cargarla y esperar a que se instalen las dependencias, inicie sesión para que otros colaboradores sepan quién es usted. Para más información, consulte Inicio de sesión.

  2. Seleccione el vínculo de invitación o abra la invitación en el explorador.

    Abra simplemente (o vuelva a abrir) el vínculo de invitación en un explorador.

    Nota

    Si no ha instalado la extensión Live Share, verá vínculos a Marketplace. Instale la extensión, reinicie la herramienta elegida e inténtelo de nuevo.

    Recibirá una notificación en la que se indica que el explorador quiere iniciar una herramienta habilitada para Live Share. Si deja que se inicie la herramienta, se conectará a la sesión de colaboración cuando se inicie.

    Captura de pantalla que muestra la página de unión en un explorador.

    Si el anfitrión está sin conexión, se le notificará. Después, puede ponerse en contacto con el anfitrión y pedirle que vuelva a compartir.

    Nota

    Asegúrese de haber iniciado la herramienta al menos una vez después de instalar la extensión Visual Studio Live Share y de que ha permitido que la instalación se realice completamente antes de abrir o volver a abrir la página de invitación. ¿Sigue teniendo problemas? Consulte Unirse manualmente.

  3. Colabore

    Ya está. En unos instantes se conectará y podrá empezar a colaborar.

    Verá que el botón Live Share cambia para convertirse en un estado de sesión. Consulte la información sobre el estado de sesión más adelante en este artículo.

    Cuando haya finalizado la unión, se le llevará automáticamente al archivo que el anfitrión está modificando.

Participar manualmente

También puede unirse manualmente sin usar un explorador web. Esta opción puede ser útil cuando la herramienta que quiere usar ya se está ejecutando, si quiere usar una herramienta que normalmente no usa o si tiene problemas para que los vínculos de invitación funcionen. El proceso es sencillo:

  1. Inicio de sesión

    Después de instalar la extensión Live Share, volver a cargarla y esperar a que se instalen las dependencias, inicie sesión para que otros colaboradores sepan quién es. Para más información, consulte Inicio de sesión.

  2. Use el comando para participar

    En la pestaña Live Share de la barra de actividad de Visual Studio Code, seleccione el botón o elemento Unirse a la sesión de colaboración:

    Captura de pantalla que muestra el botón Unirse a la sesión de colaboración.

  3. Pegue el vínculo de invitación.

    Pegue la dirección URL de la invitación que le enviamos y presione Entrar para confirmar.

  4. ¡Colabore!

    Ya está. En unos instantes, se le conectará a la sesión de colaboración.

    El botón Live Share cambia para convertirse en el estado de sesión. Consulte la información sobre el estado de sesión más adelante en este artículo.

    Cuando haya finalizado la unión, se le llevará automáticamente al archivo que el anfitrión está modificando.

Abandonar una sesión de colaboración

Como invitado, puede salir de una sesión de colaboración sin finalizarla para los demás asistentes. Para ello, simplemente cierre la ventana de Visual Studio Code. Si prefiere mantener la ventana abierta, puede abrir la pestaña Explorador de Live Sharey o la pestaña VS Live Share y seleccionar el botón Leave collaboration session (Abandonar la sesión de colaboración):

Captura de pantalla que muestra el botón Leave collaboration session (Abandonar la sesión de colaboración).

Los archivos temporales se limpian automáticamente, por lo que no es necesario hacer nada más.

¿Tiene problemas para unirse? Revise Solución de problemas.

Edición conjunta

Nota

La edición conjunta tiene limitaciones en ciertos idiomas. Para información sobre características específicas del idioma, consulte Compatibilidad con plataformas.

Cuando un invitado se une a una sesión de colaboración, todos los colaboradores podrán inmediatamente ver las modificaciones y selecciones de los demás en tiempo real. Solo tiene que tomar un archivo del explorador de archivos y empezar a editarlo. Los anfitriones e invitados verán las modificaciones a medida que se realicen y pueden contribuir, lo que facilita la iteración y la resolución rápida de problemas.

Captura de pantalla que muestra una sesión de edición conjunta.

Nota

Los invitados que se unen a una sesión de colaboración de solo lectura no pueden realizar modificaciones en los archivos. Los anfitriones puedes habilitar el modo de solo lectura cuando comparten la sesión. Como invitado, puede saber si se ha unido a una sesión de solo lectura examinando el estado de sesión.

Los participantes pueden ver cursores y modificaciones. También pueden ver las selecciones que realice. De esta forma, es fácil destacar dónde puede haber problemas o transmitir ideas.

Captura de pantalla que muestra el código seleccionado.

Usted y otros participantes pueden ir a cualquier archivo del proyecto compartido. Puede realizar modificaciones por su cuenta o en colaboración con otros usuarios, lo que significa que puede cambiar sin problemas entre la investigación, la realización de pequeños cambios o la edición totalmente colaborativa.

Las modificaciones resultantes se conservan en el equipo del anfitrión cuando se guardan. Por lo tanto, no es necesario sincronizar, insertar o enviar archivos cuando haya terminado de editar.

Sugerencia de seguridad: Como todos los participantes pueden ir y modificar 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. Como invitado, debe tener en cuenta que, como resultado de esta configuración, es posible que no vea determinados archivos. Para más información, consulte Control del acceso y la visibilidad de los archivos.

Cambio del comportamiento de la marca de participante

De forma predeterminada, Visual Studio Live Share muestra automáticamente una marca junto al cursor de un participante al mantener el puntero o cuando el participante realiza modificaciones, resalta algo o mueve el cursor. En algunos casos, puede que quiera cambiar este comportamiento.

Para ello, abra settings.json (Archivo > Preferencias > Configuración), agregue una de las siguientes líneas y, luego, reinicie Visual Studio Code.

Setting Comportamiento
"liveshare.nameTagVisibility":"Never" La marca solo es visible cuando se mantiene el puntero sobre el cursor.
"liveshare.nameTagVisibility":"Activity" Este es el valor predeterminado. La marca es visible cuando se mantiene el puntero sobre el cursor o si el participante edita, resalta o mueve el cursor.
"liveshare.nameTagVisibility":"Always" La marca siempre está visible.

Búsqueda y enumeración de participantes

Para ver rápidamente quién está en la sesión de colaboración, examine la lista de participantes en la pestaña Explorador de Live Sharey o en la pestaña VS Live Share:

Captura de pantalla que muestra los participantes de una sesión.

Para seguir a cualquier participante de esta lista, seleccione el participante del grupo de editores activo.

También, puede seleccionar Ctrl+Mayús+P o Cmd+Mayús+P y, luego, elegir Live Share: List Participants (Live Share: Mostrar participantes) o seleccionar el elemento de la barra de estado que muestra el número de participantes de la sesión:

Captura de pantalla que muestra el elemento de la barra de estado.

Aparecerá una lista de todos los participantes de la sesión. El comportamiento aquí varía con respecto al del botón de chincheta. Esta lista aparece incluso si hay solo una persona más en la sesión con usted, por lo que siempre podrá ver rápidamente dónde se encuentra otra persona. Al igual que con el botón de chincheta, puede elegir los participantes de la lista para seguirlos. Si prefiere salir, presione Escape.

Seguimiento de un colaborador

En ocasiones necesitará explicar un problema o diseño que abarque varios archivos o ubicaciones en el código. En estas situaciones, puede ser útil seguir temporalmente a sus compañeros a medida que se mueven por un proyecto. Es por esto que, cuando se una a una sesión de colaboración, seguirá automáticamente al anfitrión. Cuando esté siguiendo a alguien, el editor permanecerá sincronizado con la posición de desplazamiento y archivo abierto actualmente de esa persona.

Nota

De forma predeterminada, Live Share comparte los archivos abiertos que están fuera de la carpeta compartida. Si quiere modificar este comportamiento, cambie liveshare.shareExternalFiles a false en settings.json.

Solicitud de atención

Puede que, en ocasiones, quiera que todos los usuarios de una sesión de colaboración vean algo que está haciendo. Live Share le permite pedir a todos que centren su atención en usted con una notificación que les facilita la tarea de seguirle.

Abra la pestaña VS Live Share en la barra de actividad de Visual Studio Code o la pestaña Explorador de Live Share y seleccione el botón Atraer la atención de los participantes:

Captura de pantalla que muestra el botón Atraer la atención de los participantes.

Todos los participantes de la sesión de colaboración recibirán una notificación de que les solicita su atención:

Captura de pantalla que muestra la notificación de solicitud de atención.

En ese momento, pueden seleccionar Seguir en la notificación cuando estén listos para prestar atención a sus acciones.

Seguimiento y no seguimiento de colaboradores

Para empezar a seguir a un participante (como anfitrión o invitado), seleccione el nombre del participante de la lista en la pestaña Explorador de Live Share o en la pestaña VS Live Share. El círculo situado junto al nombre se volverá sólido para indicar que los sigue:

Captura de pantalla que muestra un participante a quien sigue.

Como alternativa, puede seleccionar el botón de chincheta de la esquina superior derecha del grupo de editores o elegir Ctrl+Alt+F o Cmd+Alt+F.

Captura de pantalla que muestra el botón de chincheta.

Nota

Si hay más de una persona en la sesión de colaboración, se le pedirá que seleccione el participante al que quiere seguir:

Captura de pantalla que muestra una lista de participantes.

Como el seguimiento está asociado a un grupo de editores, puede usar la vista dividida o el diseño de cuadrícula para crear un grupo que siga a un participante y un grupo que no lo haga. Este diseño le permite seguir pasivamente a alguien mientras también trabaja en algo de forma independiente. Cuando tenga un grupo de editores seleccionado, puede elegir un participante de la lista y hacer que ese grupo lo siga.

Captura de pantalla que muestra dos grupos de editores en la vista dividida.

Para que sea fácil salir del modo de seguimiento y empezar a editar por su cuenta, dejará de seguir automáticamente si se produce una de estas acciones:

  • Empieza a editar el archivo actualmente activo.
  • Abre un archivo distinto.
  • Cierra el archivo actualmente activo.

Además, para dejar de seguir a alguien de forma explícita, vuelva a seleccionar el botón de chincheta o elija Ctrl+Alt+F o Cmd+Alt+F.

Depuración conjunta

La característica de depuración colaborativa de Visual Studio Live Share es una manera eficaz de depurar un problema. Ofrece una experiencia colaborativa de solución de problemas. También proporciona una sesión de depuración compartida en el equipo del anfitrión que le ofrece a usted y a otros participantes de la sesión la posibilidad de investigar problemas que podrían ser específicos del entorno.

Sugerencia de seguridad: Como los participantes pueden ir y modificar 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. También debe tener en cuenta que el acceso a la consola o REPL permite a los participantes ejecutar comandos en el equipo, por lo que solo debe realizar la depuración con personas de confianza. Los invitados deben tener en cuenta que, debido a la configuración restrictiva, es posible que no puedan seguir al depurador a medida que depura paso a paso por instrucciones determinados archivos restringidos. Para más información, consulte Control del acceso y la visibilidad de los archivos.

El uso de la depuración colaborativa es sencillo.

  1. Asegúrese de que el anfitrión y todos los invitados tengan instalada la extensión de depuración adecuada. (La instalación no siempre es necesaria, pero suele ser una buena idea).

  2. El anfitrión, si todavía no está configurado para el proyecto, debe configurar launch.json para depurar la aplicación desde Visual Studio Code de la manera habitual. No se requiere ninguna configuración especial.

  3. Para empezar la depuración, el anfitrión puede usar el botón de la pestaña de depuración, de la manera habitual:

    Captura de pantalla que muestra el botón de depuración de Visual Studio Code.

    Sugerencia

    También puede participar en las sesiones de depuración de Visual Studio desde Visual Studio Code y viceversa. Para más información sobre la depuración conjunta, consulte las instrucciones de Visual Studio.

Cuando el depurador se asocia en el lado del anfitrión, también se asocian automáticamente todos los invitados. Hay una sesión de depuración ejecutándose en el equipo del anfitrión, pero todos los participantes están conectados a ella y tienen su propia vista:

Captura de pantalla que muestra el depurador de Visual Studio Code.

Cualquiera puede ejecutar paso a paso el proceso de depuración, por lo que puede cambiar entre colaboradores sin tener que negociar el control.

Nota

Consulte Compatibilidad con la plataforma para información sobre la compatibilidad con la característica de depuración por lenguaje o plataforma.

Cada colaborador puede investigar e inspeccionar variables, ir a varios archivos de la pila de llamadas e incluso agregar o quitar puntos de interrupción. Las características de edición conjunta permiten que cada participante haga un seguimiento de dónde se encuentran ubicados los demás para cambiar entre la investigación simultánea de los aspectos del problema y la depuración colaborativa.

Nota

En una sesión de colaboración de solo lectura, los invitados no podrán ejecutar paso a paso el proceso de depuración. Sin embargo, sí pueden agregar o quitar puntos de interrupción e inspeccionar variables.

Animación que muestra la depuración simultánea.

Cambio cuando Visual Studio Code se une a las sesiones de depuración

De manera predeterminada, como invitado, se le asociará automáticamente a las sesiones de depuración cuando el anfitrión las comparta. Este comportamiento puede ser problemático.

Para cambiarlo, abra settings.json (Archivo > Preferencias > Configuración), agregue una de las siguientes líneas y, luego, reinicie Visual Studio Code:

Setting Comportamiento
"liveshare.joinDebugSessionOption":"Automatic" El valor predeterminado. Como invitado, participará automáticamente en cualquier sesión de depuración que inicie el anfitrión.
"liveshare.joinDebugSessionOption":"Prompt" Como invitado, se le pedirá que se una a una sesión de depuración compartida cuando la inicie el anfitrión.
"liveshare.joinDebugSessionOption":"Manual" Como invitado, deberá unirse manualmente a las sesiones de depuración. Consulte Desasociación y nueva asociación.

Desasociación y nueva asociación

Es posible que un invitado quiera detener temporalmente la depuración. Si este es el caso, puede seleccionar el botón Detener de la barra de herramientas de depuración para desasociar el depurador sin que el anfitrión u otros invitados se vean afectados:

Captura de pantalla que muestra el botón Detener.

Si ha actualizado la configuración y ya no se asocia de manera automática o si simplemente quiere volver a asociarse más adelante, puede seleccionar Ctrl+Mayús+P o Cmd+Mayús+P o, en la barra de estado, seleccionar el elemento de estado de sesión y, luego, elegir Attach to a Shared Debugging Session (Asociar a una sesión de depuración compartida).

Captura de pantalla que muestra el comando Attach to a Shared Debugging Session (Asociar a una sesión de depuración compartida).

Uso compartido de la aplicación en ejecución en un explorador

A diferencia de Visual Studio, Visual Studio Code no admite puertos de aplicación web conocidos para tipos de proyecto como ASP.NET. Sin embargo, si va a unirse a una sesión de colaboración desde un anfitrión de Visual Studio, puede ver que su explorador web aparece automáticamente cuando se inicia la depuración. Luego, el explorador se conecta automáticamente a las aplicaciones en ejecución del anfitrión. Para más información, consulte Características de Visual Studio.

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í, los invitados de Visual Studio y Visual Studio Code pueden abrir un explorador en el mismo puerto localhost para ver la aplicación en ejecución. Para más información, consulte Uso compartido de servidores.

Uso compartido de servidores o terminales

Uso compartido de servidores

De vez en cuando, es posible que los anfitriones de las sesiones de colaboración quieran compartir con invitados una aplicación web u otros servidores o servicios que se ejecutan localmente. Por ejemplo, otros puntos de conexión de RESTful o bases de datos y otros servidores. 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.

Los invitados pueden acceder entonces al servidor que compartió en ese puerto desde sus propios equipos locales en el mismo puerto. Por ejemplo, si comparte un servidor web que se ejecuta en el puerto 3000, los invitados pueden acceder a ese mismo servidor web en ejecución en sus propios equipos en http://localhost:3000.

Esta conexión se realiza a través de un túnel SSH o SSL de seguridad mejorada entre el anfitrión y los invitados y se autentica a través del servicio. Este mecanismo de conexión ayuda a garantizar que solo las personas de la sesión de colaboración tengan acceso.

Sugerencia de seguridad: Como anfitrión, sea selectivo sobre los puertos que comparte con los invitados. Cíñase a los puertos de aplicación (en lugar de compartir un puerto del sistema). Para los invitados, los puertos compartidos se comportarán exactamente como lo harían si el servidor o servicio se estuviera ejecutando en el equipo del invitado. Este comportamiento es útil, pero puede ser arriesgado si comparte el puerto equivocado.

Por motivos de seguridad, solo los servidores que se ejecutan en los puertos que especifica estarán disponibles para los demás invitados. El anfitrión de la sesión de colaboración puede agregar uno fácilmente. A continuación se muestra cómo hacerlo:

  1. En la pestaña VS Live Share o la pestaña Explorador de Live Share, seleccione el elemento o el botón Compartir servidor:

    Captura de pantalla que muestra el botón Compartir servidor.

  2. Escriba el número del puerto en el que se ejecuta el servidor. Tiene la opción de escribir un nombre:

    Captura de pantalla que muestra el aviso de número de puerto.

Ya está. El servidor en el puerto que especificó ahora se asignará al localhost de cada invitado en el mismo puerto (a menos que ya esté en uso).

Si el puerto ya está en uso en el equipo del invitado, se seleccionará otro automáticamente. Como invitado, puede ver una lista de puertos compartidos (por nombre, si se especifica) en la pestaña Explorador de Live Share o la pestaña VS Live Share. La lista se encuentra en Servidores compartidos. Si selecciona un puerto, ese servidor se abre en el explorador. También puede hacer clic con el botón derecho y seleccionar una opción para copiar el vínculo del servidor en el Portapapeles.

Captura de pantalla que muestra la lista Servidores compartidos.

Por motivos de seguridad, los invitados no pueden controlar qué puertos del equipo del anfitrión se comparten.

Para dejar de compartir un servidor local, el anfitrión puede mantener el puntero sobre el elemento de servidor en la lista Servidores compartidos y, luego, seleccionar el botón Unshare server (Dejar de compartir servidor):

Captura de pantalla que muestra el botón Unshare server (Dejar de compartir servidor).

Uso compartido de terminales

Los desarrolladores modernos usan con frecuencia diversas herramientas de línea de comandos. Live Share permite a los anfitriones compartir un terminal con invitados. 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. Puede hacer que la salida del terminal sea visible para los invitados. También puede permitirles que ejecuten pruebas o compilaciones o incluso que evalúen las prioridades de problemas específicos del entorno que solo aparecen en su equipo.

De forma predeterminada, los terminales no se comparten porque proporcionan a los invitados acceso de solo lectura como mínimo a la salida de los comandos que se ejecutan (si no la capacidad de ejecutar los propios comandos). Esta configuración predeterminada permite ejecutar comandos en terminales locales con un riesgo reducido y compartir solo cuando sea necesario. Y solo los anfitriones pueden iniciar terminales compartidos. Esta limitación evita que los invitados inicien uno y hagan algo que no se espera.

Como anfitrión, puede compartir un terminal desde la pestaña VS Live Share o la pestaña Explorador de Live Share. Seleccione el elemento o el botón Compartir terminal:

Captura de pantalla que muestra el botón Compartir terminal.

En este momento, puede elegir si quiere que el terminal sea de solo lectura o de lectura/escritura. Si el terminal es de lectura/escritura, todos pueden escribir en él, el anfitrión incluido. Por lo tanto, como anfitrión, puede intervenir fácilmente si un invitado está haciendo algo que no le gusta.

Para estar seguro, debe proporcionar acceso de lectura y escritura a los invitados solo cuando sepa que realmente lo necesitan. Cíñase a los terminales de solo lectura cuando solo quiera que los invitados vean la salida de los comandos que ejecuta. Tenga en cuenta que el acceso de lectura y escritura proporciona a los invitados el mismo acceso al terminal que usted tiene. Así, pueden ejecutar cualquier comando del equipo que usted pueda.

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.

Captura de pantalla que muestra las opciones de nivel de acceso de solo lectura y lectura/escritura.

Cuando haya seleccionado el tipo de terminal compartido que quiere iniciar, aparecerá un nuevo terminal compartido en la pestaña Terminal de Visual Studio Code:

Captura de pantalla que muestra la pestaña Terminal de Visual Studio Code.

Si se comparten varios terminales o si su atención está en otra pestaña, puede atraer la atención a un terminal seleccionando la entrada en la lista de Terminales compartidos.

Captura de pantalla que muestra la lista Terminales compartidos.

Para finalizar una sesión del terminal, escriba exit, cierre la ventana del terminal o seleccione el botón Unshare terminal (Dejar de compartir terminal) en la pestaña Explorador de Live Share o la pestaña VS Live Share y se desconectará a todos los participantes.

Estados y limitaciones de sesión

Después de haber iniciado una sesión de colaboración o haberse unido a ella, el elemento de la barra de estado de Visual Studio Live Share refleja el estado de la sesión activa.

Estos son los estados que normalmente verá:

State Elemento de la barra de estado Descripción
Inactivo Estado de VS Code: inactivo Ninguna sesión de colaboración activa. No se comparte nada.
Anfitrión: Uso compartido en curso Estado de VS Code: uso compartido en curso Se está iniciando una sesión de colaboración. Pronto se empezará a compartir contenido.
Anfitrión: Uso compartido de recursos Estado de VS Code: uso compartido activo Una sesión de colaboración está activa. Se comparte contenido.
Anfitrión: Uso compartido de solo lectura Estado de VS Code: uso compartido de solo lectura El anfitrión está compartiendo una sesión de colaboración de solo lectura.
Invitado: Participación en la sesión Estado de VS: participación El invitado se está uniendo a una sesión de colaboración existente.
Invitado: participando Estado de VS Code: participando El invitado se ha unido y está conectado a una sesión de colaboración activa y recibe contenido compartido.
Invitado: Participando en solo lectura Estado de VS Code: participando en solo lectura El invitado se ha unido y está conectado a una sesión de colaboración de solo lectura activa.

Aunque actualmente los invitados experimentarán algunas deficiencias durante el uso de las características descritas en este artículo, los anfitriones de la sesión de colaboración conservan la funcionalidad íntegra de la herramienta elegida. Para más información, consulte:

Pasos siguientes

Consulte estos artículos adicionales para más información:

¿Tiene algún problema? Consulte la solución de problemas o envíe sus comentarios.