VCBuild vs. MSBuild: Membangun perubahan sistem di Visual Studio 2010

Sistem MSBuild untuk proyek C++ diperkenalkan di Visual Studio 2010. Di Visual Studio 2008 dan rilis sebelumnya, sistem VCBuild digunakan. Jenis dan konsep file tertentu yang bergantung pada VCBuild tidak ada atau diwakili secara berbeda dalam MSBuild. Dokumen ini membahas perbedaan dalam sistem build saat ini. Untuk mengonversi proyek Visual Studio 2008 ke MSBuild, Anda harus menggunakan Visual Studio 2010. Setelah proyek dikonversi, Anda harus menggunakan versi terbaru Visual Studio untuk meningkatkan ke IDE saat ini dan membangun alat. Untuk informasi selengkapnya, termasuk cara mendapatkan Visual Studio 2010, lihat Instruksi untuk Visual Studio 2008.

Bagian berikut ini meringkas perubahan dari VCBuild ke MSBuild. Jika proyek VCBuild Anda memiliki aturan build kustom atau makro yang tidak dikenali oleh MSBuild, lihat Visual Studio Projects - C++ untuk mempelajari cara menerjemahkan instruksi tersebut ke sistem MSBuild. Konversi awal dari VCBuild ke MSBuild hanyalah langkah perantara. Tidak perlu mengoreksi file proyek sepenuhnya atau membuat program dikompilasi tanpa kesalahan. Anda hanya menggunakan Visual Studio 2010 untuk mengonversi proyek ke format MSBuild sehingga Anda mendapatkan proyek yang berfungsi di versi terbaru Visual Studio.

.vcproj sekarang .vcxproj

File proyek tidak lagi menggunakan ekstensi nama file .vcproj. Visual Studio 2010 secara otomatis mengonversi file proyek yang dibuat oleh rilis Visual C++ sebelumnya ke format MSBuild, yang menggunakan ekstensi .vcxproj untuk file proyek.

.vsprops sekarang adalah .props

Di Visual Studio 2008 dan yang lebih lama, lembar properti proyek adalah file berbasis XML yang memiliki ekstensi nama file .vsprops. Lembar properti proyek memungkinkan Anda menentukan sakelar untuk alat build seperti pengkompilasi atau linker dan membuat makro yang ditentukan pengguna. Di MSBuild, ekstensi nama file untuk lembar properti proyek adalah .props.

Aturan build kustom dan file .rules

Di Visual Studio 2008 dan yang lebih lama, file aturan adalah file berbasis XML yang memiliki ekstensi nama file .rules. File aturan memungkinkan Anda menentukan aturan build kustom dan memasukkannya ke dalam proses build proyek Visual Studio C++. Aturan build kustom, yang dapat dikaitkan dengan satu atau beberapa ekstensi nama file, memungkinkan Anda meneruskan file input ke alat yang membuat satu atau beberapa file output.

Dalam sistem MSBuild, aturan build kustom diwakili oleh tiga jenis file, .xml, .props, dan .targets, alih-alih file .rules. Saat file .rules yang dibuat dengan menggunakan rilis Visual C++ sebelumnya dimigrasikan ke Visual Studio 2010, file .xml, .props, dan .targets yang setara dibuat dan disimpan dalam proyek Anda bersama dengan file .rules asli.

Penting

Di Visual Studio 2010, IDE tidak mendukung pembuatan aturan baru. Untuk alasan itu, cara term mudah untuk menggunakan file aturan dari proyek yang dibuat dengan menggunakan rilis Visual C++ sebelumnya adalah dengan memigrasikan proyek ke Visual Studio 2010.

Makro pewarisan

Di Visual Studio 2008 dan yang lebih lama, makro $(Inherit) menentukan urutan di mana properti yang diwariskan muncul pada baris perintah yang disusun oleh sistem build proyek. Makro $(NoInherit) menyebabkan kemunculan $(Inherit) diabaikan dan menyebabkan properti apa pun yang jika tidak akan diwariskan, tidak akan diwariskan. Misalnya, secara default makro $(Inherit) menyebabkan file yang ditentukan dengan menggunakan opsi pengkompilasi /I (Additional Include Directories) untuk ditambahkan ke baris perintah.

Di Visual Studio 2010, pewarisan didukung dengan menentukan nilai properti sebagai perangkaian satu atau beberapa nilai harfiah dan makro properti. Makro $(Inherit) dan $(NoInherit) tidak didukung.

Dalam contoh berikut, daftar yang dibatasi titik koma ditetapkan ke properti di halaman properti. Daftar ini terdiri dari perangkaian <> harfiah dan nilai properti, yang diakses dengan menggunakan notasi makro, MyPropertyMyProperty).

Property=<value>;$(MyProperty)

file .vcxproj.user

File pengguna (.vcxproj.user) menyimpan properti khusus pengguna, misalnya, pengaturan penelusuran kesalahan dan penyebaran. File vcxproj.user berlaku untuk semua proyek untuk pengguna tertentu.

file .vcxproj.filters

Ketika Penjelajah Solusi digunakan untuk menambahkan file ke proyek, file filter (.vcxproj.filters) menentukan di mana dalam tampilan pohon Penjelajah Solusi file ditambahkan, berdasarkan ekstensi nama filenya.

Pengaturan Direktori VC++

Pengaturan direktori Visual C++ ditentukan pada Halaman Properti Direktori VC++. Di Visual Studio 2008 dan yang lebih lama, pengaturan direktori berlaku per pengguna dan daftar direktori yang dikecualikan ditentukan dalam file sysincl.dat .

Anda tidak dapat mengubah pengaturan direktori VC++ jika Anda menjalankan devenv /resetsettings di baris perintah. Anda juga tidak dapat mengubah pengaturan jika Anda membuka menu Alat , klik Pengaturan Impor dan Ekspor, lalu pilih opsi Reset semua pengaturan .

Untuk memigrasikan pengaturan direktori VC++ dari file .vssettings yang dibuat oleh rilis Visual Studio sebelumnya:

1. Buka menu Alat, klik Pengaturan Impor dan Ekspor
2. Pilih Impor pengaturan lingkungan yang dipilih
3. Ikuti petunjuk dalam wizard.

Lihat juga

MSBuild pada Baris Perintah - C++