Halaman Properti Tingkat Lanjut
Halaman Properti tingkat lanjut tersedia di Visual Studio 2019 dan yang lebih baru. Untuk melihat dokumentasi untuk versi tersebut, atur kontrol pemilih Versi Visual Studio untuk artikel ini ke Visual Studio 2019 atau yang lebih baru. Kontrol tersebut dapat ditemukan di bagian atas daftar isi pada halaman ini. Di versi Visual Studio yang lebih lama, properti ini muncul di halaman properti Umum:
Halaman Properti tingkat lanjut tersedia di Visual Studio 2019 dan yang lebih baru. Properti tertentu yang ditampilkan bergantung pada jenis proyek. Proyek Windows Runtime (Platform Windows Universal, atau UWP) tidak menampilkan halaman ini.
Properti Tingkat Lanjut
Ekstensi File Target
Menentukan ekstensi file yang akan digunakan untuk output build. Default ke .exe
untuk aplikasi, .lib
untuk pustaka statis dan .dll
untuk DLL.
Ekstensi untuk Dihapus saat Bersih
Perintah menu Build>Clean menghapus file dari direktori perantara tempat konfigurasi proyek dibuat. Sistem build menghapus file yang memiliki ekstensi yang ditentukan saat Anda menjalankan perintah Bersihkan atau saat Anda membangun kembali. Sistem build juga menghapus output build yang diketahui di mana pun lokasinya. File yang dihapus mencakup output perantara seperti .obj
file. Gunakan titik koma (;
) untuk memisahkan ekstensi. Anda dapat menentukan karakter kartubebas (*
, ?
) dalam ekstensi.
Untuk mengakses properti ini secara terprogram, lihat DeleteExtensionsOnClean.
File Log Build
Memungkinkan Anda menentukan lokasi non-default untuk file log yang dibuat setiap kali Anda membuat proyek. Lokasi default ditentukan oleh makro $(IntDir)$(MSBuildProjectName).log
.
Anda dapat menggunakan makro proyek untuk mengubah lokasi direktori. Untuk informasi selengkapnya, lihat Makro umum untuk perintah dan properti build.
Arsitektur Alat Build Pilihan
Menentukan apakah akan menggunakan alat build x86 atau x64.
Menggunakan Pustaka Debug
Menentukan apakah akan membuat build Debug atau Rilis. Terlepas dari namanya, Gunakan Pustaka Debug adalah properti khusus sistem build yang secara efektif singkatan untuk "Buat build Debug" atau "Buat build Rilis". Ini mengatur beberapa properti pengkompilasi dan linker untuk build Debug atau Rilis, termasuk pengaturan pustaka. Anda dapat menggunakannya untuk membuat konfigurasi Debug atau Rilis untuk platform baru atau di templat baru. Kami tidak menyarankan Anda mengubah properti ini dalam konfigurasi yang ada. Gunakan properti pengkompilasi dan linker individual sebagai gantinya.
Mengaktifkan build Unity (JUMBO)
Memungkinkan proses build yang lebih cepat yang menggabungkan banyak file sumber C++ ke dalam satu atau beberapa file sebelum kompilasi. File gabungan ini dikenal sebagai file unity . Mereka tidak terkait dengan mesin game Unity.
Salin Konten ke OutDir
Salin item yang ditandai sebagai konten dalam proyek ke direktori output proyek ($(OutDir)
). Pengaturan ini dapat menyederhanakan penyebaran. Properti ini tersedia mulai dari Visual Studio 2019 versi 16.7.
Salin Referensi Proyek ke OutDir
Salin item referensi proyek yang dapat dieksekusi (file DLL dan EXE) ke direktori output proyek ($(OutDir)
). Dalam proyek C++/CLI (/clr
), properti ini diabaikan. Sebagai gantinya, properti Salin Lokal pada setiap referensi proyek mengontrol apakah properti tersebut disalin ke direktori output. Pengaturan ini dapat menyederhanakan penyebaran lokal. Ini tersedia mulai di Visual Studio 2019 versi 16.7.
Salin Simbol Referensi Proyek ke OutDir
Salin file PDB untuk item referensi proyek bersama dengan item yang dapat dieksekusi referensi proyek ke direktori output proyek ($(OutDir)
). Properti ini selalu diaktifkan untuk proyek C++/CLI. Pengaturan ini dapat menyederhanakan penyebaran debug. Ini tersedia mulai di Visual Studio 2019 versi 16.7.
Salin Runtime C++ ke OutDir
Salin DLL runtime ke direktori output proyek ($(OutDir)
). Pengaturan ini dapat menyederhanakan penyebaran lokal. Ini tersedia mulai di Visual Studio 2019 versi 16.7.
Penggunaan MFC
Menentukan apakah proyek MFC secara statis atau dinamis ditautkan ke DLL MFC. Proyek non-MFC pilih Gunakan Pustaka Windows Standar.
Untuk mengakses properti ini secara terprogram, lihat useOfMfc.
Tataan Karakter
Menentukan apakah _UNICODE
makro atau _MBCS
prapemrosesan harus diatur. Juga mempengaruhi titik entri linker, jika sesuai.
Untuk mengakses properti ini secara terprogram, lihat CharacterSet.
Pengoptimalan Seluruh Program
/GL
Menentukan opsi pengkompilasi dan /LTCG
opsi pengtaut. Secara default, properti ini dinonaktifkan untuk konfigurasi Debug, dan diaktifkan untuk konfigurasi Rilis.
Versi Toolset MSVC
Menentukan versi lengkap toolset MSVC yang digunakan untuk membangun proyek. Anda mungkin memiliki berbagai versi pembaruan dan pratinjau kumpulan alat yang terinstal. Anda dapat menentukan mana yang akan digunakan di sini.
Versi Toolset LLVM
Menentukan versi lengkap toolset LLVM yang digunakan untuk membangun proyek. Properti ini tersedia ketika LLVM (clang-cl) dipilih sebagai toolset platform, dimulai di Visual Studio 2019 versi 16.9. Untuk informasi selengkapnya, lihat Mengatur versi toolset LLVM kustom.
Mengaktifkan Output Terstruktur MSVC
Menentukan apakah akan mengaktifkan output SARIF terstruktur, yang memungkinkan jendela Detail Masalah dan output hierarkis di jendela Output di Visual Studio.
Properti C++/CLI
Dukungan Common Language Runtime
/clr
Menyebabkan opsi pengkompilasi digunakan.
Untuk mengakses properti ini secara terprogram, lihat ManagedExtensions.
Versi .NET Target Framework
Properti ini hanya berlaku ketika properti dukungan Common Language Runtime diatur ke Dukungan Runtime .NET Framework, yaitu proyek menargetkan .NET Framework, dan menentukan versi .NET Framework.
.NET Target Framework
Properti ini hanya berlaku ketika properti dukungan Common Language Runtime diatur ke Dukungan Runtime .NET, yaitu proyek menargetkan .NET.
Properti ini menentukan Moniker Kerangka Kerja Target .NET 5+ target proyek ini, misalnya net6.0-windows
atau net7.0-windows8.0
.
Aktifkan Build Inkremental Terkelola
Untuk proyek terkelola, opsi ini memungkinkan deteksi visibilitas eksternal saat Anda membuat rakitan. Jika perubahan pada proyek terkelola tidak terlihat oleh proyek lain, proyek dependen tidak dibangun kembali. Build inkremental terkelola dapat secara dramatis meningkatkan waktu build dalam solusi yang mencakup proyek terkelola.
Aktifkan Dukungan CLR untuk File Individual
Opsi ini mengatur ManagedAssembly
properti build yang hanya memungkinkan pembuatan beberapa file dalam proyek sebagai kode terkelola. Anda harus mengatur Aktifkan Dukungan CLR untuk File Individual ke Ya jika beberapa tetapi tidak semua file proyek Anda dibuat sebagai kode terkelola. Properti ini hanya tersedia dalam proyek yang menggunakan toolset v143 atau yang lebih baru di Visual Studio 2022 dan versi yang lebih baru.
Versi Windows Target .NET
Properti ini hanya berlaku ketika properti dukungan Common Language Runtime diatur ke Dukungan Runtime .NET, yaitu proyek menargetkan .NET.
Properti ini menentukan versi Windows minimum yang didukung proyek. Nilai ini digunakan oleh NuGet untuk menentukan kompatibilitas proyek dan dependensi paket NuGet. Jika proyek A bergantung pada proyek B, proyek A target .NET versi Windows harus lebih besar atau sama dengan proyek B.