Implementación, ejecución y depuración del proyecto de MSBuild de Linux

Una vez que haya creado un proyecto de C++ basado en MSBuild para Linux en Visual Studio y se haya conectado a él mediante el Administrador de conexiones de Linux, puede ejecutar y depurar el proyecto. Compile, ejecute y depure el código en el destino remoto.

Hay varias formas de interactuar con el proyecto de Linux y de depurarlo.

• Depure con las características tradicionales de Visual Studio, como son los puntos de interrupción, las ventanas Inspección y mantener el mouse sobre una variable. Con estos métodos, puede depurar como lo haría normalmente para otros tipos de proyecto.

• Vea la salida del equipo de destino en la ventana de la consola de Linux. También puede usar la consola para enviar la entrada al equipo de destino.

Depurar el proyecto de Linux

1. Seleccione el modo de depuración en la página de propiedades Depuración.

   GDB se usa para depurar aplicaciones que se ejecutan en Linux. Al depurar en un sistema remoto (no WSL), GDB se puede ejecutar en dos modos diferentes, que pueden seleccionarse desde la opción Modo de depuración de la página de propiedades Depuración del proyecto:

   

   GDB se usa para depurar aplicaciones que se ejecutan en Linux. GDB se puede ejecutar en dos modos diferentes, que pueden seleccionarse desde la opción Modo de depuración de la página de propiedades Depuración del proyecto:

   

   • En modo gdbserver, GDB se ejecuta localmente, con lo que se conecta a gdbserver, en el sistema remoto. Para usarlo, debe proporcionar una ruta de acceso local de Windows a GDB en Ruta del depurador en Visual Studio 2022, versión 17.6 y posteriores, o en Ruta de acceso de GDB en Visual Studio 2019 versión 16.11 y versiones anteriores. Para obtener más información sobre dónde proporcionar la ruta de acceso a GDB para proyectos de CMake, consulte Opciones adicionales permitidas con la configuración de gdbserver (16.7 o posterior).

   • En el modo gdb, el depurador de Visual Studio controla GDB en el sistema remoto. Esta opción es más recomendable si la versión local de GDB no es compatible con la versión instalada en el equipo de destino. Este es el único modo que admite la ventana Consola de Linux.

     Nota

     Si no es posible alcanzar puntos de interrupción en el modo de depuración gdbserver, pruebe el modo gdb. En primer lugar, gdb debe instalarse en el destino remoto.

2. Seleccione el destino remoto a través de la barra de herramientas estándar Depurar de Visual Studio.

   Cuando el destino remoto esté disponible, verá que aparece por nombre o dirección IP:

   

   Si aún no se ha conectado al destino remoto, verá instrucciones para usar el Administrador de conexiones de Linux para conectarse al destino remoto:

   

3. Establezca un punto de interrupción; para ello, haga clic en el margen interno izquierdo de una parte del código que sabe que se ejecutará. Un punto rojo aparece en la línea de código en la que estableció el punto de interrupción.

4. Presione F5 (o Depurar > Iniciar depuración) para iniciar la depuración.

   Al iniciar la depuración, la aplicación se compila en el destino remoto antes de comenzar. Los errores de compilación aparecen en la ventana Lista de errores .

   Si no hay errores, la aplicación se inicia y el depurador se detiene en el punto de interrupción:

   

   Ahora, puede interactuar con la aplicación en su estado actual, ver variables y recorrer el código mediante teclas de comando como F10 o F11.

5. Si quiere usar la consola de Linux para interactuar con la aplicación, seleccione Depurar > Consola de Linux.

   

   Esta consola muestra la salida de la consola del equipo de destino y toma la entrada y la envía al equipo de destino.

   

Configuración de otras opciones de depuración (proyectos de MSBuild)

• Se pueden pasar argumentos de línea de comandos al ejecutable mediante el elemento Argumentos de programa de la página de propiedades Depuración del proyecto.

• Puede exportar la variable de entorno DISPLAY mediante el comando anterior al inicio en las páginas de propiedades de depuración del proyecto. Por ejemplo: export DISPLAY=:0.0

  

• Se pueden pasar opciones concretas del depurador a GDB mediante la entrada Comandos adicionales del depurador. Por ejemplo, es posible que quiera pasar por alto las señales SIGILL (instrucciones no válidas). Puede usar el comando handle para lograrlo agregando lo siguiente a la entrada Comandos adicionales del depurador que se muestra anteriormente: handle SIGILL nostop noprint.

• Especifique la ruta de acceso a la GDB usada por Visual Studio mediante el elemento Ruta de acceso de GDB en la página de propiedades Depuración del proyecto. Esta opción está disponible en Visual Studio 2019, versión 16.9 y posteriores.

Depurar con la opción Asociar al proceso

La página de propiedades Depuración de los proyectos de Visual Studio y la configuración Launch.vs.json de los proyectos de CMake tienen ambas una opción que permite establecer una asociación con un proceso en ejecución. Si necesita más control del que se proporciona en esta opción, puede colocar un archivo denominado Microsoft.MIEngine.Options.xml en la raíz de la solución o el área de trabajo. A continuación se muestra un sencillo ejemplo:

<?xml version="1.0" encoding="utf-8"?>
<SupplementalLaunchOptions>
    <AttachOptions>
      <AttachOptionsForConnection AdditionalSOLibSearchPath="/home/user/solibs">
        <ServerOptions MIDebuggerPath="C:\Program Files (x86)\Microsoft Visual Studio\Preview\Enterprise\Common7\IDE\VC\Linux\bin\gdb\7.9\x86_64-linux-gnu-gdb.exe"
ExePath="C:\temp\ConsoleApplication17\ConsoleApplication17\bin\x64\Debug\ConsoleApplication17.out"/>
        <SetupCommands>
          <Command IgnoreFailures="true">-enable-pretty-printing</Command>
        </SetupCommands>
      </AttachOptionsForConnection>
    </AttachOptions>
</SupplementalLaunchOptions>

AttachOptionsForConnection tiene la mayoría de los atributos que probablemente necesite. En el ejemplo anterior se muestra cómo especificar una ubicación para buscar más .so bibliotecas. El elemento secundario ServerOptions permite asociar al proceso remoto con gdbserver en su lugar. Para ello, deberá especificar un cliente de gdb local (arriba se muestra el que venía incluido en Visual Studio 2017) y una copia local del archivo binario con símbolos. El elemento SetupCommands permite pasar comandos directamente a gdb. Puede encontrar todas las opciones disponibles en el esquema LaunchOptions.xsd en GitHub.

<ItemGroup>
   <RemoteDeploy Include="__example.cpp">
<!-- This is the source Linux machine, can be empty if DeploymentType is LocalRemote -->
      <SourceMachine>$(RemoteTarget)</SourceMachine>
      <TargetMachine>$(RemoteDebuggingTarget)</TargetMachine>
      <SourcePath>~/example.cpp</SourcePath>
      <TargetPath>~/example.cpp</TargetPath>
<!-- DeploymentType can be LocalRemote, in which case SourceMachine will be empty and SourcePath is a local file on Windows -->
      <DeploymentType>RemoteRemote</DeploymentType>
<!-- Indicates whether the deployment contains executables -->
      <Executable>true</Executable>
   </RemoteDeploy>
</ItemGroup>

"disableDeploy": false,
"deployDirectory": "~\foo",
"deploy" : [
   {
      "sourceMachine": "127.0.0.1 (username=example1, port=22, authentication=Password)",
      "targetMachine": "192.0.0.1 (username=example2, port=22, authentication=Password)",
      "sourcePath": "~/example.cpp",
      "targetPath": "~/example.cpp",
      "executable": "false"
   }
]

Pasos siguientes

• Para depurar dispositivos ARM en Linux, consulte la entrada de blog Debugging an embedded ARM device in Visual Studio (Depuración de un dispositivo ARM incrustado en Visual Studio).

Consulte también

Propiedades de depuración de C++ (C++ para Linux)