Tujuan artikel ini adalah untuk memberi tahu sedikit tentang MSBuild, menunjukkan target dan tugas apa yang ada di MSBuild, mempelajari cara bekerja dengan file .csproj, dan menyediakan tautan yang bermanfaat. Jika Anda memiliki judul yang lebih cocok untuk artikel tersebut, saya akan senang untuk membahasnya di komentar.

Menu

• Konsep dasar - apa itu target dan tugas di MSBuild
• MSBuild Build Lifecycle - Apa Urutan Pemanggilan Target?
• Mempersiapkan lingkungan sebagai contoh
• Penargetan di MSBuild - Contoh Menggunakan Beberapa Target MSBuild
• Membuat Target MSBuild Anda Sendiri
• Tugas di MSBuild - contoh penggunaan beberapa tugas MSBuild
• Variabel dan makro dalam .csproj
• Referensi

Konsep dasar ( Menu )

MSBuild dirancang sedemikian rupa sehingga perakitan proyek dibagi menjadi beberapa tahap.

Target adalah tahap tertentu (peristiwa) yang terjadi selama perakitan proyek. Anda dapat menggunakan target standar, atau menentukan target Anda sendiri.

Tugas adalah tugas yang dapat dilakukan pada tahap tertentu. Anda dapat menggunakan tugas standar atau membuat tugas Anda sendiri.

Kutipan dari dokumentasi tentang penargetan ( https://docs.microsoft.com/en-us/visualstudio/msbuild/msbuild-targets ):

Targetkan tugas-tugas kelompok bersama dalam urutan tertentu dan memungkinkan proses pembangunan diperhitungkan dalam unit yang lebih kecil.
Misalnya, satu target dapat menghapus semua file di direktori output untuk mempersiapkan build, sementara yang lain
mengkompilasi input untuk proyek dan menempatkannya di direktori kosong.

Siklus Hidup MSBuild Build ( Menu )

Untuk MSBuild, Microsoft telah menetapkan sejumlah target standar (dalam file Microsoft.Common.targets, Microsoft.CSharp.targets, dll.). Sejumlah besar target berbeda didefinisikan, tetapi dalam artikel ini kami tidak akan membahas ini secara rinci. Beberapa target standar (dipesan):


Target BeforeBuild dan AfterBuild dirancang khusus untuk diganti dan dapat digunakan. Saya tidak merekomendasikan menggunakan target yang tersisa dari daftar sehingga tidak ada yang rusak .

Untuk tampilan daftar target yang lebih rinci, Anda dapat menggunakan opsi / pp:. Berkat parameter ini, sebuah file akan dihasilkan di mana semua impor akan disertakan (termasuk file .targets). Anda dapat menemukan banyak target dan variabel di dalamnya (terima kasih aikixd untuk tipnya).

Mempersiapkan lingkungan sebagai contoh ( Menu )

Sebagai contoh, Anda perlu:

• Visual Studio Lingkungan Pengembangan Terpasang
• Buat proyek jenis Aplikasi Konsol bernama MSBuildExample
• Buka folder proyek dan temukan file MSBuildExample.csproj di sana
• Buka file MSBuildExample.csproj di notepad atau editor lain

Dalam semua contoh di artikel ini, Anda perlu mengedit file MSBuildExample.csproj. Setiap contoh melibatkan menghapus kode dari contoh sebelumnya dan menambahkan yang baru. Kode harus ditambahkan di akhir file .csproj ke baris terakhir yang berisi tag Proyek penutup.



Perhatian! Dalam file .csproj, kasus penting .
Untuk menjalankan contoh, Anda harus menjalankan build di lingkungan pengembangan Visual Studio. Untuk beberapa contoh, Anda harus memilih konfigurasi solusi.



Hasilnya akan ditampilkan di jendela Output di Visual Studio (bawah). Jika tidak, buka melalui item menu View => Output.

Menargetkan dalam MSBuild ( Menu )

Sebagai contoh, kami akan menggunakan tugas Pesan , yang akan menampilkan informasi di jendela Output di Visual Studio. Seperti yang disebutkan sebelumnya, ada target standar BeforeBuild dan AfterBuild, kami akan menggunakannya. Untuk pelatihan, bacalah bagian Mempersiapkan lingkungan sebagai contoh .


Seperti yang Anda lihat, pesan tugas dieksekusi, yang menampilkan teks yang kami tentukan pada saat BeforeBuild dan AfterBuild di jendela Output di Visual Studio.
Ketika mendefinisikan target dengan nama yang sama, itu ditimpa!


Hanya pesan kedua yang ditampilkan, karena mereka menggunakan target dengan nama yang sama dan ditimpa oleh nilai kedua.

Membuat Target MSBuild Anda Sendiri ( Menu )

Jika target BeforeBuild dan AfterBuild tidak cukup atau Anda ingin tugas dieksekusi pada tahap lain dari siklus hidup perakitan, Anda dapat menentukan target Anda sendiri. Untuk tujuan ini, ada parameter Sebelum Target dan AfterTarget.


Dua target khusus ditentukan - MyCustomBeforeTarget dan MyCustomAfterTarget.
Target MyCustomBeforeTarget dijalankan sebelum target BeforeBuild karena kami menetapkan:

 BeforeTargets="BeforeBuild" 

Target MyCustomAfterTarget dijalankan setelah target BeforeBuild karena kami menetapkan:

 AfterTargets="BeforeBuild" 

Tugas di MSBuild ( Menu )

Artikel ini tidak membahas bagaimana Anda dapat menulis tugas Anda sendiri, tetapi sebelum Anda menulis tugas, periksa daftar tugas yang disediakan oleh Microsoft .

Mari kita lihat beberapa contoh penggunaan tugas dan makro.

Variabel dan makro di .csproj ( Menu )

Sejumlah makro standar dapat digunakan dalam file .csproj, daftar mereka dapat ditemukan di sini https://msdn.microsoft.com/en-us/library/c02as0cs.aspx dan di sini https://msdn.microsoft.com/en-us/ library / bb629394.aspx . Pertimbangkan beberapa makro berguna:

• $ (MSBuildToolsPath) - menunjukkan jalur ke folder MSBuild. Sebagai contoh, C: \ Program Files (x86) \ MSBuild \ 14.0 \ Bin. Saat menggabungkan jalur, gunakan makro ini dengan garis miring. Misalnya, $ (MSBuildToolsPath) \ Microsoft.Web.Publishing.Tasks.dll. Kalau tidak, itu bisa salah membentuk jalur dan memberikan kesalahan bahwa file tidak ditemukan.
• $ (OutputPath) - jalur relatif ke folder output. Sebagai contoh, bin \ Stage. Gunakan makro ini dengan garis miring, misalnya, $ (OutputPath) \ $ (TargetFileName) .config.
  
• $ (TargetFileName) - nama file output dengan ekstensi. Misalnya, MSBuildExample.exe. Ekstensi dan format nama file output mungkin berbeda dari berbagai jenis proyek. Dengan menggunakan makro ini, Anda dapat dengan aman menentukan nama file konfigurasi nantinya. Ini mungkin berguna untuk transformasi konfigurasi.
• $ (Konfigurasi) adalah nama konfigurasi saat ini. Misalnya, Lepaskan, Debug
• $ (IntermediateOutputPath) - path ke folder obj. Misalnya, obj \ Stage.

Untuk menentukan parameter Anda sendiri, gunakan PropertyGroup . Contoh mendefinisikan variabel Anda sendiri dapat ditemukan di bagian tugas di MSBuild .

Tautan ( Menu )

• dokumentasi penargetan
• dokumentasi tugas
• daftar tugas yang disediakan oleh Microsoft
• kondisi
• informasi makro
• informasi variabel
• membangun informasi proses
• memesan target eksekusi
• informasi file target
• beberapa informasi lebih lanjut tentang penargetan dan proses pembuatan. Ada juga tautan ke serangkaian artikel tentang transformasi