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 .

Screenshot of the Visual Studio Installer Individual Components page that shows Clang components available for installation.

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).

Screenshot of the Visual Studio Installer Individual Components page that shows Clang components available for installation.

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:

    Screenshot of the controls at the top of the C Make Settings dialog, with the Add Configuration control highlighted.

  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:

    Screenshot of the Add Configuration to C Make Settings dialog for Clang configuration.

  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:

    Screenshot of the General dialog box showing that the Toolset is selected and clang cl x 86 is highlighted.

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:

Screenshot of the C Make Settings dialog box with the C Make C X X Compiler highlighted.

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.

Screenshot of the Visual Studio debugger debugging a CMake Clang project.