Dukungan Clang/LLVM dalam proyek Visual Studio

Anda dapat menggunakan Visual Studio 2019 versi 16.2 dan yang lebih baru dengan Clang/LLVM untuk mengedit, membangun, dan men-debug proyek C++ Visual Studio (MSBuild) yang menargetkan Windows atau Linux.

Instal

Untuk dukungan IDE terbaik di Visual Studio, sebaiknya gunakan alat pengkompilasi Clang terbaru untuk Windows. Jika Anda belum memiliki alat, Anda dapat menginstalnya dengan membuka Alat Penginstal Visual Studio dan memilih alat C++ Clang untuk Windows di bawah Pengembangan desktop dengan komponen opsional C++ . Anda mungkin lebih suka menggunakan penginstalan Clang yang ada pada komputer Anda; jika demikian, pilih dukungan MSBuild untuk toolset LLVM (clang-cl).

Microsoft C++ Standard Library memerlukan setidaknya Clang 8.0.0.

Tab Komponen individual dipilih di alat penginstal. C++ Clang Compiler untuk Windows dipilih. Dukungan MSBuild untuk toolset LLVM (clang-cl) juga dipilih.

Versi Visual Studio yang lebih baru menyediakan versi toolset Clang yang lebih baru. Versi Clang yang dibundel akan diperbarui secara otomatis untuk tetap terkini dengan pembaruan dalam implementasi Microsoft dari Pustaka Standar. Misalnya, Visual Studio 2019 versi 16.11 menyertakan Clang v12.

Mengonfigurasi proyek Windows untuk menggunakan alat Clang

Untuk mengonfigurasi proyek Visual Studio untuk menggunakan Clang, klik kanan pada simpul proyek di Penjelajah Solusi dan pilih Properti. Biasanya, Anda harus terlebih dahulu memilih Semua konfigurasi di bagian atas dialog. Kemudian, di bawah Set Alat Platform Umum>, pilih LLVM (clang-cl) lalu OK.

Halaman properti proyek terbuka ke halaman Properti Konfigurasi > Umum. Dropdown Platform Toolset dipilih, di mana LLVM (clang-cl) dipilih.

Jika Anda menggunakan alat Clang yang dibundel dengan Visual Studio, tidak ada langkah tambahan yang diperlukan. Untuk proyek Windows, Visual Studio secara default memanggil Clang dalam mode clang-cl . Ini menautkan dengan implementasi Microsoft dari Pustaka Standar. Secara default, clang-cl.exe terletak di *%VCINSTALLDIR%\Tools\Llvm\bin\* dan *%VCINSTALLDIR%\Tools\Llvm\x64\bin\*.

Jika Anda menggunakan penginstalan Clang kustom, Anda dapat mengubah nilai LLVMInstallDir properti . Untuk informasi selengkapnya, lihat Mengatur lokasi LLVM kustom.

Mengonfigurasi proyek Linux untuk menggunakan alat Clang

Untuk proyek Linux, Visual Studio menggunakan frontend yang kompatibel dengan Clang GCC. Properti proyek dan hampir semua bendera kompilator identik

Untuk mengonfigurasi proyek Visual Studio Linux untuk menggunakan Clang:

1. Klik kanan pada simpul proyek di Penjelajah Solusi dan pilih Properti.
2. Biasanya, Anda harus terlebih dahulu memilih Semua konfigurasi di bagian atas dialog.
3. Di bawah Set Alat Platform Umum>, pilih Clang untuk Subsistem Windows untuk Linux jika Anda menggunakan Subsistem Windows untuk Linux (WSL). Pilih Clang untuk Linux Jarak Jauh jika Anda menggunakan komputer jarak jauh atau VM.
4. Tekan OK.

Halaman properti proyek terbuka ke halaman Properti Konfigurasi > Umum. Platform Toolset dipilih dan dari daftar opsi, LLVM (clang- c l) dipilih."

Di Linux, Visual Studio secara default menggunakan lokasi Clang pertama yang ditemukannya di properti lingkungan PATH. Jika Anda menggunakan penginstalan Clang kustom, ubah nilai LLVMInstallDir properti atau masukkan jalur di bawah Properti>Konfigurasi Properti>Proyek>VC++ Direktori Yang Dapat Dieksekusi DIrectories.> Untuk informasi selengkapnya, lihat Mengatur lokasi LLVM kustom.

Mengatur lokasi dan toolset LLVM kustom

Untuk mengatur jalur kustom ke LLVM dan mengatur versi toolset LLVM kustom untuk satu atau beberapa proyek, buat file Directory.build.props . Kemudian, tambahkan file tersebut ke folder akar proyek apa pun. Anda dapat menambahkannya ke folder solusi akar untuk menerapkannya ke semua proyek dalam solusi. File akan terlihat seperti contoh ini (tetapi gunakan jalur LLVM dan nomor versi Anda yang sebenarnya):

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

Mengatur versi toolset LLVM kustom di IDE

Mulai visual Studio 2019 versi 16.9, Anda dapat mengatur versi toolset kustom untuk LLVM di Visual Studio. Untuk mengatur properti ini dalam proyek:

1. Buka kotak dialog Halaman Properti proyek. Untuk informasi selengkapnya, lihat Mengatur properti kompilator dan build C++.

2. Pilih halaman properti Umum Properti>Konfigurasi.

3. Ubah properti Platform Toolset ke LLVM (clang-cl), jika belum diatur. Pilih Terapkan untuk menyimpan perubahan Anda.

4. Pilih halaman properti Tingkat Lanjut Properti>Konfigurasi.

5. Ubah properti Versi Toolset LLVM ke versi pilihan Anda, lalu pilih OK untuk menyimpan perubahan Anda.

Properti Versi Toolset LLVM hanya muncul saat toolset platform LLVM dipilih.

Saat Anda menambahkan Directory.build.props file ke proyek atau solusi, pengaturan muncul sebagai default dalam dialog Halaman Properti proyek. Namun, perubahan pada properti ini di Visual Studio mengambil alih pengaturan dalam Directory.build.props file.

Mengatur properti, mengedit, membangun, dan men-debug

Setelah Anda menyiapkan konfigurasi Clang, klik kanan lagi pada simpul proyek dan pilih Muat ulang proyek. Anda sekarang dapat membangun dan men-debug proyek menggunakan alat Clang. Visual Studio mendeteksi bahwa Anda menggunakan pengkompilasi Clang dan menyediakan IntelliSense, penyorotan, navigasi, dan fitur pengeditan lainnya. Kesalahan dan peringatan ditampilkan di Jendela Output. Halaman properti proyek untuk konfigurasi Clang mirip dengan yang untuk MSVC. Namun, beberapa fitur yang bergantung pada kompilator seperti Edit dan Lanjutkan tidak tersedia untuk konfigurasi Clang. Anda dapat mengatur opsi pengkompilasi atau pengtaut Clang yang tidak tersedia di halaman properti. Tambahkan secara manual di halaman properti di bawah Properti>Konfigurasi C/C++ (atau Linker)>Opsi Tambahan Baris>Perintah.

Saat penelusuran kesalahan, Anda dapat menggunakan titik henti, visualisasi memori dan data, dan sebagian besar fitur penelusuran kesalahan lainnya.

Bagian aplikasi yang terlihat membuat vektor string dan menambahkan beberapa string ke dalamnya. Eksekusi telah berhenti pada titik henti untuk kode: v.push_back("Clang/LLVM");."