Compartir a través de


Compatibilidad con Clang/LLVM en proyectos de CMake de Visual Studio

La compatibilidad con Clang está disponible a partir de Visual Studio 2019.

Puede usar Visual Studio con Clang para editar y depurar proyectos de CMake en C++ que tengan como destino Windows o Linux.

Windows: a partir de Visual Studio 2019 versión 16.1, Visual Studio incluye compatibilidad para editar, compilar y depurar con Clang/LLVM en proyectos de CMake que tienen como destino Windows.

Linux: para los proyectos de CMake de Linux, no se requiere compatibilidad especial con Visual Studio. Puede instalar Clang mediante el administrador de paquetes de distribución y agregar los comandos adecuados en el archivo CMakeLists.txt.

Instalar

Para obtener la mejor compatibilidad con el IDE de Visual Studio, se recomienda usar las herramientas más recientes del compilador de Clang para Windows. Si aún no las tiene, puede instalarlas mediante el Instalador de Visual Studio si elige Compilador de Clang en C++ para Windows en los componentes opcionales de Desarrollo para el escritorio con C++. Es posible que prefiera usar una instalación de Clang existente en la máquina; Si es así, elija el componente C++ Clang-cl para las herramientas de compilación v142 o Clang-cl de C++ para v143 .

Captura de pantalla de la página Componentes individuales del Instalador de Visual Studio en la que se muestran los componentes de Clang disponibles para la instalación.

Para obtener la mejor compatibilidad con el IDE de Visual Studio, se recomienda usar las herramientas más recientes del compilador de Clang para Windows. Si aún no las tiene, puede instalarlas mediante el Instalador de Visual Studio si elige Compilador de Clang en C++ para Windows en los componentes opcionales de Desarrollo para el escritorio con C++. Es posible que prefiera usar una instalación de Clang existente en la máquina; Si es así, elija el componente del conjunto de herramientas de MSBuild para LLVM (clang-cl).

Captura de pantalla de la página Componentes individuales del Instalador de Visual Studio en la que se muestran los componentes de Clang disponibles para la instalación.

Creación de una nueva configuración

Para agregar una nueva configuración de Clang a un proyecto de CMake:

  1. Haga clic con el botón derecho en el archivo CMakeLists.txt en el Explorador de soluciones y seleccione CMake settings for project (Configuración de CMake para el proyecto).

  2. En Configuraciones, presione el botón Agregar configuración:

    Captura de pantalla de los controles de la parte superior del cuadro de Configuración de CMake, con el control para agregar configuración resaltado.

  3. Elija la configuración de Clang que quiera (tenga en cuenta que se proporcionan configuraciones de Clang independientes para Windows y Linux) y, a continuación, haga clic en Seleccionar:

    Captura de pantalla del cuadro de diálogo Agregar configuración a CMakeSettings para la configuración de Clang.

  4. Para realizar modificaciones en esta configuración, use el Editor de configuración de CMake. Para obtener más información, vea Personalización de la configuración de compilación de CMake en Visual Studio.

Modificación de una configuración existente para usar Clang

Para modificar una configuración existente para que use Clang, siga estos pasos:

  1. Haga clic con el botón derecho en el archivo CMakeLists.txt en el Explorador de soluciones y seleccione CMake settings for project (Configuración de CMake para el proyecto).

  2. En General, seleccione la lista desplegable Conjunto de herramientas y elija el conjunto de herramientas de Clang que quiera:

    Captura de pantalla del cuadro de diálogo General que muestra que se seleccionó el Conjunto de herramientas y que se resalta clang_cl_x86.

Ubicaciones de Clang personalizadas

De forma predeterminada, Visual Studio busca Clang en dos ubicaciones:

  • (Windows) La copia instalada internamente de Clang/LLVM que viene con el instalador de Visual Studio.
  • (Windows y Linux) La variable de entorno PATH.

Para especificar otra ubicación, establezca las variables CMAKE_C_COMPILER y CMAKE_CXX_COMPILER de CMake en Configuración de CMake:

Captura de pantalla del cuadro de diálogo Configuración de CMake con la opción CMAKE_CXX_COMPILER resaltada.

Modos de compatibilidad de Clang

En las configuraciones de Windows, CMake llama a Clang de forma predeterminada en el modo clang-cl y lo vincula con la implementación de Microsoft de la biblioteca estándar. De forma predeterminada, clang-cl.exe se encuentra en C:\Program Files (x86)\Microsoft Visual Studio\2019\Common7\IDE\CommonExtensions\Microsoft\Llvm\bin.

Puede modificar estos valores desde Configuración de CMake en Caché y variables de CMake. Haga clic en Mostrar variables avanzadas. Desplácese hacia abajo hasta encontrar CMAKE_CXX_COMPILER y, a continuación, haga clic en el botón Examinar para especificar otra ruta de acceso del compilador.

Edición, compilación y depuración

Después de especificar una configuración de Clang, puede compilar y depurar el proyecto. Visual Studio detecta que está usando el compilador de Clang y proporciona IntelliSense, resaltado, navegación y otras características de edición. Los errores y las advertencias se muestran en Ventana de salida.

Al depurar, puede usar puntos de interrupción, visualización de datos y de la memoria, y la mayoría del resto de características de depuración. Algunas características dependientes del compilador, como Editar y continuar, no están disponibles para las configuraciones de Clang.

Captura de pantalla del depurador de Visual Studio depurando un proyecto de Clang para CMake.