Obsługa języka Clang/LLVM w projektach programu Visual Studio

W programie Visual Studio 2019 w wersji 16.2 lub nowszej można używać programu Clang/LLVM do edytowania, kompilowania i debugowania projektów programu Visual Studio C++ (MSBuild) przeznaczonych dla systemu Windows lub Linux.

Instalowanie

Aby uzyskać najlepszą obsługę środowiska IDE w programie Visual Studio, zalecamy użycie najnowszych narzędzi kompilatora Clang dla systemu Windows. Jeśli nie masz jeszcze narzędzi, możesz je zainstalować, otwierając Instalator programu Visual Studio i wybierając narzędzia C++ Clang dla systemu Windows w obszarze Programowanie aplikacji klasycznych za pomocą opcjonalnych składników języka C++. Wolisz użyć istniejącej instalacji języka Clang na maszynie; Jeśli tak, wybierz opcję Obsługa programu MSBuild dla zestawu narzędzi LLVM (clang-cl).

Standardowa biblioteka Microsoft C++ wymaga co najmniej Clang 8.0.0.

W instalatorze jest wybrana karta Poszczególne składniki. Wybrano kompilator C++ Clang dla systemu Windows. Wybrano również obsługę programu MSBuild dla zestawu narzędzi LLVM (clang-cl).

Nowsze wersje programu Visual Studio udostępniają nowsze wersje zestawu narzędzi Clang. Pakietowa wersja języka Clang jest aktualizowana automatycznie, aby zachować aktualność dzięki aktualizacjom w implementacji biblioteki standardowej firmy Microsoft. Na przykład program Visual Studio 2019 w wersji 16.11 zawiera język Clang w wersji 12.

Konfigurowanie projektu systemu Windows do używania narzędzi Clang

Aby skonfigurować projekt programu Visual Studio do używania języka Clang, kliknij prawym przyciskiem myszy węzeł projektu w Eksplorator rozwiązań i wybierz polecenie Właściwości. Zazwyczaj należy najpierw wybrać pozycję Wszystkie konfiguracje w górnej części okna dialogowego. Następnie w obszarze Ogólne>zestaw narzędzi platformy wybierz pozycję LLVM (clang-cl), a następnie przycisk OK.

Strona właściwości projektu jest otwarta na stronie Właściwości konfiguracji > Ogólne. Zostanie wybrana lista rozwijana Zestaw narzędzi platformy, na której jest wybrana opcja LLVM (clang-cl).

Jeśli używasz narzędzi Clang, które są dołączone do programu Visual Studio, nie są wymagane żadne dodatkowe kroki. W przypadku projektów systemu Windows program Visual Studio domyślnie wywołuje język Clang w trybie clang-cl . Łączy się ona z implementacją biblioteki standardowej przez firmę Microsoft. Domyślnie clang-cl.exe znajduje się w systemach *%VCINSTALLDIR%\Tools\Llvm\bin\* i *%VCINSTALLDIR%\Tools\Llvm\x64\bin\*.

Jeśli używasz niestandardowej instalacji języka Clang, możesz zmienić wartość LLVMInstallDir właściwości. Aby uzyskać więcej informacji, zobacz Ustawianie niestandardowej lokalizacji LLVM.

Konfigurowanie projektu systemu Linux do korzystania z narzędzi Clang

W przypadku projektów systemu Linux program Visual Studio używa frontonu zgodnego z językiem Clang GCC. Właściwości projektu i prawie wszystkie flagi kompilatora są identyczne

Aby skonfigurować projekt programu Visual Studio Dla systemu Linux do używania języka Clang:

1. Kliknij prawym przyciskiem myszy węzeł projektu w Eksplorator rozwiązań i wybierz polecenie Właściwości.
2. Zazwyczaj należy najpierw wybrać pozycję Wszystkie konfiguracje w górnej części okna dialogowego.
3. W obszarze Ogólne>zestaw narzędzi platformy wybierz pozycję Clang dla Podsystem Windows dla systemu Linux, jeśli używasz Podsystem Windows dla systemu Linux (WSL). Wybierz pozycję Clang dla zdalnego systemu Linux , jeśli używasz maszyny zdalnej lub maszyny wirtualnej.
4. Naciśnij przycisk OK.

Strona właściwości projektu jest otwarta na stronie Właściwości konfiguracji > Ogólne. Wybrano zestaw narzędzi platformy, a z listy opcji wybrano maszynę wirtualną LLVM (clang- c l).

W systemie Linux program Visual Studio domyślnie używa pierwszej lokalizacji Clang znalezionej we właściwości środowiska PATH. Jeśli używasz niestandardowej instalacji języka Clang, zmień wartość LLVMInstallDir właściwości lub wprowadź ścieżkę w obszarze Właściwości projektu>Właściwości>konfiguracji programu>VC++ Katalogi wykonywalne DIrectories.> Aby uzyskać więcej informacji, zobacz Ustawianie niestandardowej lokalizacji LLVM.

Ustawianie niestandardowej lokalizacji maszyny wirtualnej LLVM i zestawu narzędzi

Aby ustawić niestandardową ścieżkę do maszyny WIRTUALNEJ LLVM i ustawić niestandardową wersję zestawu narzędzi LLVM dla co najmniej jednego projektu, utwórz plik Directory.build.props . Następnie dodaj ten plik do folderu głównego dowolnego projektu. Możesz dodać go do folderu rozwiązania głównego, aby zastosować go do wszystkich projektów w rozwiązaniu. Plik powinien wyglądać podobnie do tego przykładu (ale użyj rzeczywistej ścieżki llVM i numeru wersji):

<Project>
  <PropertyGroup>
    <LLVMInstallDir>C:\MyLLVMRootDir</LLVMInstallDir>
    <LLVMToolsVersion>15.0.0</LLVMToolsVersion>
  </PropertyGroup>
</Project>

Ustawianie niestandardowej wersji zestawu narzędzi LLVM w środowisku IDE

Począwszy od programu Visual Studio 2019 w wersji 16.9, możesz ustawić niestandardową wersję zestawu narzędzi dla maszyny wirtualnej LLVM w programie Visual Studio. Aby ustawić tę właściwość w projekcie:

1. Otwórz okno dialogowe Strony właściwości projektu. Aby uzyskać więcej informacji, zobacz Ustawianie właściwości kompilatora języka C++ i kompilacji.

2. Wybierz stronę Właściwości> ogólne konfiguracji.

3. Zmodyfikuj właściwość zestawu narzędzi platformy do maszyny wirtualnej LLVM (clang-cl), jeśli nie jest jeszcze ustawiona. Wybierz pozycję Zastosuj , aby zapisać zmiany.

4. Wybierz stronę Właściwości>zaawansowane konfiguracji.

5. Zmodyfikuj właściwość Wersja zestawu narzędzi LLVM do preferowanej wersji, a następnie wybierz przycisk OK , aby zapisać zmiany.

Właściwość Wersja zestawu narzędzi LLVM jest wyświetlana tylko po wybraniu zestawu narzędzi platformy LLVM.

Po dodaniu Directory.build.props pliku do projektu lub rozwiązania ustawienia są wyświetlane jako domyślne w oknie dialogowym Strony właściwości projektu. Jednak zmiany tych właściwości w programie Visual Studio zastępują ustawienia w Directory.build.props pliku.

Ustawianie właściwości, edytowanie, kompilowanie i debugowanie

Po skonfigurowaniu konfiguracji języka Clang kliknij ponownie prawym przyciskiem myszy węzeł projektu i wybierz polecenie Załaduj ponownie projekt. Teraz możesz kompilować i debugować projekt przy użyciu narzędzi języka Clang. Program Visual Studio wykrywa, że używasz kompilatora Clang i udostępnia funkcję IntelliSense, wyróżnianie, nawigację i inne funkcje edycji. Błędy i ostrzeżenia są wyświetlane w oknie Dane wyjściowe. Strony właściwości projektu dla konfiguracji Clang są podobne do tych dla MSVC. Jednak niektóre funkcje zależne od kompilatora, takie jak Edytuj i Kontynuuj, nie są dostępne dla konfiguracji języka Clang. Możesz ustawić opcję kompilatora języka Clang lub konsolidatora, która nie jest dostępna na stronach właściwości. Dodaj ją ręcznie na stronach właściwości w obszarze Właściwości>konfiguracji C/C++ (lub konsolidator)>Opcje dodatkowe wiersza>polecenia.

Podczas debugowania można używać punktów przerwania, pamięci i wizualizacji danych oraz większości innych funkcji debugowania.

Część widocznej aplikacji tworzy wektor ciągu i dodaje do niej kilka ciągów. Wykonanie zostało zatrzymane w punkcie przerwania dla kodu: v.push_back("Clang/LLVM");".