Partilhar via

Suporte a Clang/LLVM em projetos do Visual Studio CMake

O suporte a Clang está disponível a partir do Visual Studio 2019.

Você pode usar o Visual Studio com Clang para editar e depurar projetos C++ CMake destinados ao Windows ou Linux.

Windows: A partir do Visual Studio 2019 versão 16.1, o Visual Studio inclui suporte para edição, criação e depuração com Clang/LLVM em projetos CMake destinados ao Windows.

Linux: Para projetos Linux CMake, nenhum suporte especial do Visual Studio é necessário. Você pode instalar o Clang usando o gerenciador de pacotes da sua distro e adicionar os comandos apropriados no arquivo CMakeLists.txt.

Instalar

Para obter o melhor suporte a IDE no Visual Studio, recomendamos o uso das ferramentas de compilador Clang mais recentes para Windows. Se você ainda não tiver esses, você pode instalá-los abrindo o Visual Studio Installer e escolhendo compilador C++ Clang para Windows em Desenvolvimento Desktop com componentes opcionais C++ . Você pode preferir usar uma instalação Clang existente em sua máquina; em caso afirmativo, escolha o componente C++ Clang-cl for v142 build tools ou C++ Clang-cl for v143 build tools .

Captura de tela da página Componentes individuais do instalador do Visual Studio. C++ Clang Compiler For Windows e C++ Clang-cl for v142 build tools são selecionados.

Para obter o melhor suporte a IDE no Visual Studio, recomendamos o uso das ferramentas de compilador Clang mais recentes para Windows. Se você ainda não tiver esses, você pode instalá-los abrindo o Visual Studio Installer e escolhendo compilador C++ Clang para Windows em Desenvolvimento Desktop com componentes opcionais C++ . Você pode preferir usar uma instalação Clang existente em sua máquina; em caso afirmativo, escolha o suporte MSBuild para o componente do conjunto de ferramentas LLVM (clang-cl).

Captura de tela da página Componentes individuais do instalador do Visual Studio. C++ Clang Compiler For Windows e MSBuild suporte para LLVM são selecionados.

Criar uma nova configuração

Para adicionar uma nova configuração Clang a um projeto CMake:

  1. Clique com o botão direito do mouse em CMakeLists.txt no Gerenciador de Soluções e escolha as configurações do CMake para o projeto.

  2. Em Configurações, pressione o botão Adicionar configuração :

    Captura de tela dos controles na parte superior da caixa de diálogo Configurações de configuração C. O botão Adicionar configuração está realçado.

  3. Escolha a configuração Clang desejada (observe que configurações Clang separadas são fornecidas para Windows e Linux) e pressione Select:

    Captura de tela da caixa de diálogo Adicionar configuração ao C Make Settings para configuração do Clang. Contém entradas como Mingw64-Release, x86-Debug, x64-Debug, x86-Clang Debug e assim por diante.

  4. Para fazer modificações nessa configuração, use o CMake Settings Editor. Para obter mais informações, consulte Personalizar configurações de compilação do CMake no Visual Studio.

Modificar uma configuração existente para usar o Clang

Para modificar uma configuração existente para usar o Clang, siga estas etapas:

  1. Clique com o botão direito do mouse em CMakeLists.txt no Gerenciador de Soluções e escolha as configurações do CMake para o projeto.

  2. Em Geral , selecione a lista suspensa Conjunto de ferramentas e escolha o conjunto de ferramentas Clang desejado:

    Captura de tela da caixa de diálogo Geral mostrando a lista suspensa Conjunto de ferramentas e clang cl x 86 realçada.

Locais Clang personalizados

Por padrão, o Visual Studio procura Clang em dois locais:

  • (Windows) A cópia instalada internamente do Clang/LLVM que vem com o instalador do Visual Studio.
  • (Windows e Linux) A variável de ambiente PATH.

Você pode especificar outro local definindo as variáveis CMAKE_C_COMPILER e CMAKE_CXX_COMPILER CMake em Configurações do CMake:

Captura de ecrã da caixa de diálogo C Make Settings com o compilador C Make C X X realçado. As configurações do C Make são listadas, como x64-Clang-Debug, Linux-Clang-Release e assim por diante.

Modos de compatibilidade Clang

Para configurações do Windows, o CMake por padrão invoca Clang no modo clang-cl e vincula-se à implementação da Microsoft da Biblioteca Padrão. Por padrão, clang-cl.exe está localizado em C:\Program Files (x86)\Microsoft Visual Studio\2019\Common7\IDE\CommonExtensions\Microsoft\Llvm\bin.

Você pode modificar esses valores em Configurações do CMake em Variáveis e cache do CMake. Clique em Mostrar variáveis avançadas. Desloque-se para baixo para encontrar CMAKE_CXX_COMPILER e, em seguida, clique no botão Procurar para especificar um caminho de compilador diferente.

Editar, compilar e depurar

Depois de configurar uma configuração Clang, você pode compilar e depurar o projeto. O Visual Studio deteta que você está usando o compilador Clang e fornece IntelliSense, realce, navegação e outros recursos de edição. Erros e avisos são exibidos na janela de saída.

Ao depurar, pode utilizar pontos de interrupção, visualização de memória e dados, e a maioria dos outros recursos de depuração. Alguns recursos dependentes do compilador, como Editar e Continuar, não estão disponíveis para configurações do Clang.

Captura de tela do depurador do Visual Studio depurando um projeto CMake Clang.

  • Last updated on