Glosarium MSBuild

Istilah-istilah ini digunakan untuk menjelaskan Microsoft Build Engine (MSBuild) dan komponennya.

AssemblyFoldersEx

Lokasi registri tempat vendor pihak ketiga menyimpan jalur untuk setiap versi kerangka kerja yang didukungnya di mana resolusi waktu desain dapat terlihat untuk menemukan rakitan referensi.

pembuatan batch

Pembuatan batch berarti membagi item ke dalam kategori berbeda yang dikenal sebagai batch, berdasarkan metadata item, lalu jalankan target atau tugas satu kali dengan menggunakan setiap batch. Pembuatan batch adalah MSBuild yang setara dengan konstruksi for--loop. Untuk informasi selengkapnya, lihat Batching.

cakupan build

Cakupan build menjelaskan objek MSBuild, misalnya, properti global, yang berpotensi terlihat oleh proyek dan proyek turunan apa pun yang dibuat dalam build multi-proyek.

proyek turunan

Lihat proyek, turunan.

kondisi

Banyak elemen MSBuild dapat didefinisikan secara kondisional; artinya, Condition atribut muncul di elemen. Konten elemen kondisional diabaikan kecuali kondisi mengevaluasi ke true. Untuk informasi selengkapnya, lihat Syarat-syarat.

definisi, item

Lihat definisi item.

item emit

Selama fase eksekusi build, item dapat dibuat atau dimodifikasi oleh tugas yang memiliki elemen turunan Output yang memiliki atribut ItemName. Tugas ini dapat dikatakan "memancarkan" item baru.

memancarkan properti

Selama fase eksekusi build, properti dapat dibuat atau dimodifikasi oleh tugas yang memiliki elemen turunan Output yang memiliki atribut PropertyName. Tugas ini dapat dikatakan "memancarkan" properti baru.

fase evaluasi

Evaluasi adalah fase pertama dari build proyek. Properti dievaluasi dalam urutan muncul dalam file proyek. Proyek yang diimpor dievaluasi saat ditemui dalam proyek. Target dan tugas tidak dijalankan hingga fase eksekusi, dan properti atau item apa pun yang akan mereka nyatakan atau keluarkan diabaikan selama evaluasi.

fase eksekusi

Eksekusi adalah fase kedua dari build proyek. Target yang dipilih dibangun dan tugas dijalankan. Properti dan item dapat dibuat atau dimodifikasi dibandingkan dengan nilai evaluasinya.

fungsi, properti

Lihat fungsi properti.

fungsi, item

Lihat fungsi item.

item

Item adalah input ke dalam sistem build, dan dikelompokkan ke dalam jenis item berdasarkan nama elemennya. Item biasanya mewakili file. Karena item dinamai oleh jenis item tempat item tersebut berada, istilah item dan nilai item dapat digunakan secara bergantian. Untuk informasi selengkapnya, lihat Item.

definisi item

Grup definisi item berisi definisi item yang menambahkan metadata default ke jenis item apa pun. Seperti metadata terkenal, metadata default dikaitkan dengan semua item jenis item yang Anda tentukan. Metadata default dapat ditimpa secara eksplisit dalam definisi item. Untuk informasi selengkapnya, lihat Definisi citra.

fungsi item

Fungsi item mendapatkan informasi tentang item dalam proyek. Fungsi-fungsi ini menyederhanakan mendapatkan item Distinct() dan lebih cepat daripada mengulangi item. Ada fungsi untuk memanipulasi jalur dan string item. Untuk informasi selengkapnya, lihat fungsi item.

metadata item

Lihat metadata, item.

jenis Item

Jenis item diberi nama daftar item yang dapat digunakan sebagai parameter untuk tugas. Tugas menggunakan nilai item untuk melakukan langkah-langkah proses build. Untuk informasi selengkapnya, lihat Item.

metadata, item

Metadata item adalah kumpulan pasangan nama-nilai yang terkait dengan item. Metadata menyediakan informasi deskriptif untuk item dan bersifat opsional, kecuali untuk metadata terkenal. Untuk informasi selengkapnya, lihat Item.

metadata, terkenal

Metadata terkenal adalah metadata item baca-saja yang diinisialisasi dengan menggunakan nilai yang telah ditentukan sebelumnya. Metadata terkenal menyediakan informasi deskriptif untuk item yang mereferensikan file. Misalnya, nilai metadata terkenal bernama FullPath adalah jalur lengkap dari file yang dirujuk. Untuk informasi selengkapnya, lihat Item.

multitarget

Kemampuan untuk aplikasi atau proyek perakitan untuk menargetkan banyak CLR dan kerangka kerja yang berbeda dari MSBuild dan dari Visual Studio.

profil

Subset kerangka kerja lengkap. Ini digunakan untuk meminimalkan jumlah yang perlu diunduh ke komputer.

file proyek

file proyek berisi skrip MSBuild yang mengontrol build. Project file biasanya memiliki ekstensi file yang berakhiran dengan proj, seperti .csproj atau .vbproj. file Project dapat mengimpor file properti dan file target.

properti

Properti adalah pasangan kunci-nilai yang digunakan untuk mengontrol proses build. Untuk informasi selengkapnya, lihat properti MSBuild.

properti, lingkungan

Properti lingkungan adalah properti yang secara otomatis diinisialisasi ke nilai variabel lingkungan sistem yang memiliki nama yang sama. Untuk informasi selengkapnya, lihat properti MSBuild.

file properti

File properti adalah file proyek yang sebagian besar berisi grup properti dan grup item yang memandu build. Menurut konvensi, Ini memiliki ekstensi file .props. File properti biasanya diimpor di awal file proyek terkait.

properti, fungsi

Fungsi properti adalah properti sistem atau metode yang dapat digunakan untuk mengevaluasi skrip MSBuild. Metode properti dapat digunakan untuk membaca waktu sistem, membandingkan string, mencocokkan ekspresi reguler, dan melakukan tindakan lainnya. Untuk informasi selengkapnya, lihat Prosedur Properti.

fungsi properti, berlapis

Fungsi properti dapat digabungkan untuk membentuk fungsi yang lebih kompleks. Contohnya,

$([MSBuild]::BitwiseAnd(32, $([System.IO.File]::GetAttributes(tempFile))))

Untuk informasi selengkapnya, lihat Prosedur Properti.

properti, global

Properti global adalah pasangan kunci-nilai yang digunakan untuk mengontrol proses build. Properti global diatur pada prompt perintah, atau dengan menggunakan Properties atribut tugas MSBuild, dan tidak dapat dimodifikasi selama fase evaluasi build. Untuk informasi selengkapnya, lihat properti MSBuild.

properti, lokal

Properti lokal adalah pasangan kunci-nilai yang digunakan untuk mengontrol proses build. Istilah ini hanya digunakan untuk membedakan properti yang bukan properti global.

properti, registri

Properti registri memiliki nilai yang diatur dengan menggunakan sintaks khusus yang membaca nilai subkuntang registri sistem. Untuk informasi selengkapnya, lihat properti MSBuild.

properti, dicadangkan

Properti yang dipesan adalah pasangan kunci-nilai yang digunakan untuk mengontrol proses build. Properti yang dipesan secara otomatis diinisialisasi ke nilai yang telah ditentukan sebelumnya. Untuk informasi selengkapnya, lihat properti MSBuild.

cakupan proyek

cakupan Project menjelaskan objek MSBuild, misalnya, properti lokal, yang hanya terlihat dalam file proyek yang berisi dan ke proyek apa pun yang diimpornya.

proyek, turunan

Proyek turunan dibuat oleh tugas MSBuild selama build proyek. Proyek baru ini adalah turunan dari proyek yang berisi atau mengimpor target yang berisi tugas MSBuild. Proyek turunan mewarisi properti global proyek induk, kecuali jika dimodifikasi oleh Properties atribut.

daftar redist

Daftar redistribusi: daftar rakitan yang sesuai dengan kerangka kerja tertentu.

rakitan referensi

Rakitan yang digunakan selama waktu desain untuk membuat aplikasi. Rakitan referensi dapat memiliki kode aktual dan antarmuka privat yang dihapus darinya, hanya menyisakan metadata dan antarmuka publik.

properti registri

Lihat properti, registri.

target

Target mengelompokkan tugas bersama-sama dalam urutan tertentu dan mengekspos bagian file proyek sebagai titik masuk ke dalam proses build. Untuk informasi selengkapnya, lihat Target.

target, membangun

Lihat target, berjalan.

target, mengevaluasi

Karena kompilasi inkremental, target harus dianalisis untuk potensi perubahan terhadap properti dan item. Bahkan jika target dilompati, perubahan ini harus dilakukan. Mengevaluasi target berarti melakukan analisis ini dan membuat perubahan ini. Untuk informasi selengkapnya, lihat Build bertambah bertahap.

target, mengeksekusi

Menjalankan target berarti mengevaluasinya dan menjalankan semua tugas yang tidak memiliki syarat, atau yang syaratnya dievaluasi ke true. Selama kompilasi bertambah bertahap, target dapat dilewati atau dijalankan, tetapi selalu dievaluasi. Untuk informasi selengkapnya, lihat target, evaluasi.

target, berjalan

Target yang memiliki kondisi yang mengevaluasi ke false tidak dijalankan, yaitu, tidak berpengaruh pada build. Target yang berjalan dieksekusi atau dilewati. Dalam kasus manapun, target dievaluasi. Untuk informasi selengkapnya, lihat target, evaluasi.

target, melompati

Jika kompilasi inkremental menentukan bahwa semua file output sudah diperbarui, maka target dilewati, yaitu, target dievaluasi, tetapi tugas dalam target tidak dijalankan. Untuk informasi selengkapnya, lihat target, evaluasi.

moniker kerangka kerja target

Nama yang menjelaskan kerangka kerja (seperti . NETFramework, Silverlight, dll.), versi, dan profil (seperti Klien, Server, dll.) yang ingin ditargetkan.

paket penargetan

Daftar rakitan yang didistribusikan dengan kerangka kerja tertentu dan set rakitan referensi untuk kerangka kerja tersebut.

file targets

File target adalah file proyek yang sebagian besar berisi target dan tugas yang memandu build. Menurut konvensi, Ini memiliki ekstensi file .targets. File target biasanya diimpor di akhir file proyek terkait.

tugas

Tugas adalah unit kode yang dapat dieksekusi yang digunakan oleh proyek MSBuild untuk melakukan operasi build. Misalnya, tugas mungkin mengompilasi file input atau menjalankan alat eksternal. Untuk informasi selengkapnya, lihat Tugas.

transform

Transformasi adalah konversi satu-ke-satu dari satu daftar item ke koleksi item lainnya. Selain mengaktifkan proyek untuk mengonversi koleksi item, transformasi memungkinkan target untuk mengidentifikasi pemetaan langsung antara input dan outputnya. Untuk mengetahui informasi selengkapnya, lihat Transformasi.

Metadata terkenal

Lihat metadata, terkenal.

Baca juga

• MSBuild