MSBuild pada baris perintah - C++

Secara umum, kami sarankan Anda menggunakan Visual Studio untuk mengatur properti proyek dan memanggil sistem MSBuild. Namun, Anda dapat menggunakan alat MSBuild langsung dari prompt perintah. Proses build dikontrol oleh informasi dalam file proyek (.vcxproj) yang dapat Anda buat dan edit. File proyek menentukan opsi build berdasarkan tahap build, kondisi, dan peristiwa. Selain itu, Anda dapat menentukan argumen opsi baris perintah nol atau lebih.

msbuild.exe [ project_file ] [ opsi ]

Gunakan opsi baris perintah /target (atau /t) dan /property (atau /p) untuk mengambil alih properti dan target tertentu yang ditentukan dalam file proyek.

Fungsi penting dari file proyek adalah menentukan target, yang merupakan operasi tertentu yang diterapkan pada proyek Anda, dan input dan output yang diperlukan untuk melakukan operasi tersebut. File proyek dapat menentukan satu atau beberapa target, yang dapat menyertakan target default.

Setiap target terdiri dari urutan satu atau beberapa tugas. Setiap tugas diwakili oleh kelas .NET Framework yang berisi satu perintah yang dapat dieksekusi. Misalnya, tugas CL berisi perintah cl.exe.

Parameter tugas adalah properti tugas kelas dan biasanya mewakili opsi baris perintah dari perintah yang dapat dieksekusi. Misalnya, FavorSizeOrSpeed parameter CL tugas sesuai dengan opsi pengkompilasi /Os dan /Ot .

Parameter tugas tambahan mendukung infrastruktur MSBuild. Misalnya, Sources parameter tugas menentukan sekumpulan tugas yang dapat digunakan oleh tugas lain. Untuk informasi selengkapnya tentang tugas MSBuild, lihat Referensi Tugas.

Sebagian besar tugas memerlukan input dan output, seperti nama file, jalur, dan string, numerik, atau parameter Boolean. Misalnya, input umum adalah nama file sumber .cpp untuk dikompilasi. Parameter input penting adalah string yang menentukan konfigurasi dan platform build, misalnya, "Debug|Win32". Input dan output ditentukan oleh satu atau beberapa elemen XML Item yang ditentukan pengguna yang ItemGroup terkandung dalam elemen.

File proyek juga dapat menentukan properti dan ItemDefinitionGroupitem yang ditentukan pengguna. Properti dan item membentuk pasangan nama/nilai yang dapat digunakan sebagai variabel dalam build. Komponen nama pasangan mendefinisikan makro, dan komponen nilai mendeklarasikan nilai makro. Makro properti diakses dengan menggunakan notasi $(name), dan makro item diakses dengan menggunakan notasi %(name).

Elemen XML lainnya dalam file proyek dapat menguji makro, lalu secara kondisional mengatur nilai makro apa pun atau mengontrol eksekusi build. Nama makro dan string harfiah dapat digabungkan untuk menghasilkan konstruksi seperti jalur dan nama file. Pada baris perintah, opsi /property mengatur atau mengambil alih properti proyek. Item tidak dapat dirujuk pada baris perintah.

Sistem MSBuild dapat secara kondisional menjalankan target sebelum atau sesudah target lain. Selain itu, sistem dapat membangun target berdasarkan apakah file yang dikonsumsi target lebih baru daripada file yang dikeluarkannya.

Untuk informasi selengkapnya tentang MSBuild, lihat:

• Gambaran Umum MSBuild tentang konsep MSBuild.

• Informasi Referensi Referensi MSBuild tentang sistem MSBuild.

• Referensi Skema File Proyek Mencantumkan elemen Skema XML MSBuild, bersama dengan atributnya, dan elemen induk dan turunan. Terutama perhatikan elemen ItemGroup, PropertyGroup, Target, dan Task .

• Referensi Baris Perintah Menjelaskan argumen dan opsi baris perintah yang dapat Anda gunakan dengan msbuild.exe.

• Referensi Tugas Menjelaskan tugas MSBuild. Terutama perhatikan tugas-tugas ini, yang khusus untuk Visual C++: Tugas BscMake, Tugas CL, Tugas CPPClean, Tugas LIB, Tugas Tautan, Tugas MIDL, Tugas MT, Tugas RC, Tugas SetEnv, Tugas VCMessage

Di Bagian Ini

Istilah	Definisi
Panduan: Menggunakan MSBuild untuk Membuat Proyek C++	Menunjukkan cara membuat proyek Visual Studio C++ menggunakan MSBuild.
Cara: Menggunakan Peristiwa Build di Proyek MSBuild	Menunjukkan cara menentukan tindakan yang terjadi pada tahap partikuler dalam build: sebelum build dimulai; sebelum langkah tautan dimulai; atau setelah build berakhir.
Cara: Menambahkan Langkah Build Kustom ke Proyek MSBuild	Menunjukkan cara menambahkan tahap yang ditentukan pengguna ke urutan build.
Cara: Menambahkan Alat Build Kustom ke Proyek MSBuild	Menunjukkan cara mengaitkan alat build dengan file tertentu.
Cara: Mengintegrasikan Alat Kustom ke dalam Properti Proyek	Menunjukkan cara menambahkan opsi untuk alat kustom ke properti proyek.
Cara: Memodifikasi Kerangka Kerja Target dan Toolset Platform	Menunjukkan cara mengkompilasi proyek untuk beberapa kerangka kerja atau toolset.

Baca juga

Menggunakan toolset MSVC dari baris perintah