Share via


MSBuild sözlüğü

Bu terimler, Microsoft Derleme Altyapısı'nı (MSBuild) ve bileşenlerini açıklamak için kullanılır.

AssemblyFoldersEx

Üçüncü taraf satıcıların, tasarım zamanı çözümlemesinin başvuru derlemelerini bulmak için bakabileceği çerçevenin her sürümü için yolları depoladığı kayıt defteri konumu.

toplu işleme

Toplu işlem, öğeleri öğe meta verilerine göre toplu iş olarak bilinen farklı kategorilere bölmek ve ardından her toplu işlemi kullanarak bir hedef veya görevi bir kez çalıştırmak anlamına gelir. Batching, for--loop yapısının MSBuild eşdeğeridir. Daha fazla bilgi için bkz . Batching.

derleme kapsamı

Derleme kapsamı, bir MSBuild nesnesini( örneğin, bir projede ve çok projeli bir derlemede oluşturulan tüm alt projeler için görünür olabilecek genel bir özellik) açıklar.

alt proje

Bkz. proje, çocuk.

koşul

Birçok MSBuild öğesi koşullu olarak tanımlanabilir; diğer bir ifadeyle Condition özniteliği öğesinde görünür. Koşul olarak değerlendirilmediği truesürece koşullu öğelerin içeriği yoksayılır. Daha fazla bilgi için bkz . Koşullar.

tanım, öğe

Bkz . öğe tanımı.

öğeyi yay

Derlemenin yürütme aşamasında, özniteliğine sahip ItemName alt Output öğeleri olan görevler tarafından öğeler oluşturulabilir veya değiştirilebilir. Görevin yeni öğeleri "yaydığı" söylenir.

emit özelliği

Derlemenin yürütme aşamasında özellikler, özniteliğine sahip PropertyName alt Output öğeleri olan görevler tarafından oluşturulabilir veya değiştirilebilir. Görevin yeni özelliği "yaydığı" söylenir.

değerlendirme aşaması

Değerlendirme, proje derlemesinin ilk aşamasıdır. Tüm özellikler ve öğeler, projede göründükleri sırayla değerlendirilir. İçeri aktarılan projeler, projede karşılaşıldıkları gibi değerlendirilir. Hedefler ve görevler yürütme aşamasına kadar çalıştırılmaz ve bildirdikleri veya yayacakları özellikler veya öğeler değerlendirme sırasında yoksayılır.

yürütme aşaması

Yürütme, proje derlemesinin ikinci aşamasıdır. Seçilen hedefler oluşturulur ve görevler çalıştırılır. Özellikler ve öğeler, değerlendirme değerlerine göre oluşturulabilir veya değiştirilebilir.

işlev, özellik

Bkz. özellik işlevi.

işlev, öğe

Bkz. öğe işlevi.

öğe

Öğeler derleme sistemine giriştir ve öğe adlarına göre öğe türlerine göre gruplandırılır. Öğeler genellikle dosyaları temsil eden öğelerdir. Öğeler ait oldukları öğe türüne göre adlandırıldığından, madde ve öğe değeri terimleri birbirinin yerine kullanılabilir. Daha fazla bilgi için bkz . Öğeler.

öğe tanımı

Öğe tanımı grupları, herhangi bir öğe türüne varsayılan meta veriler ekleyen öğe tanımları içerir. İyi bilinen meta veriler gibi, varsayılan meta veriler de belirtilen öğe türünün tüm öğeleriyle ilişkilendirilir. Varsayılan meta veriler bir öğe tanımında açıkça geçersiz kılınabilir. Daha fazla bilgi için bkz . Öğe tanımları.

item işlevi

Öğe işlevleri, projedeki öğeler hakkında bilgi alır. Bu işlevler Distinct() öğelerini almayı basitleştirir ve öğeler arasında döngüden daha hızlıdır. Öğe yollarını ve dizelerini işlemek için işlevler vardır. Daha fazla bilgi için bkz . Öğe işlevleri.

öğe meta verileri

Bkz. meta veriler, öğe.

öğe türü

Öğe türleri, görevler için parametre olarak kullanılabilecek öğelerin adlandırılmış listeleridir. Görevler, derleme işleminin adımlarını gerçekleştirmek için öğe değerlerini kullanır. Daha fazla bilgi için bkz . Öğeler.

meta veriler, öğe

Öğe meta verileri, bir öğeyle ilişkilendirilmiş bir ad-değer çiftleri koleksiyonudur. Meta veriler öğe için açıklayıcı bilgiler sağlar ve iyi bilinen meta veriler dışında isteğe bağlıdır. Daha fazla bilgi için bkz . Öğeler.

meta veriler, iyi bilinen

İyi bilinen meta veriler, önceden tanımlanmış bir değer kullanılarak başlatılan salt okunur öğe meta verileridir. İyi bilinen meta veriler, dosyaya başvuran bir öğe için açıklayıcı bilgiler sağlar. Örneğin, adlı FullPath iyi bilinen meta verilerin değeri, başvuruda bulunılan dosyanın tam yoludur. Daha fazla bilgi için bkz . Öğeler.

çoklu sürüm desteği

Bir uygulama veya derleme projesinin MSBuild'den ve Visual Studio'dan birçok farklı CLR'yi ve çerçeveyi hedefleme yeteneği.

profil

Tam çerçevenin alt kümesi. Bu, bir makineye indirilmesi gereken miktarı en aza indirmek için kullanılır.

proje dosyası

Proje dosyası, derlemeyi denetleen MSBuild betiğini içerir. Proje dosyaları genellikle .csproj veya .vbproj gibi proj ile biten bir dosya uzantısına sahiptir. Proje dosyaları özellik dosyalarını ve hedef dosyaları içeri aktarabilir.

özellik

Özellik, derleme işlemini denetlemek için kullanılan bir anahtar-değer çiftidir. Daha fazla bilgi için bkz . MSBuild özellikleri.

özellik, ortam

Ortam özelliği, aynı ada sahip bir sistem ortam değişkeninin değerine otomatik olarak başlatılan bir özelliktir. Daha fazla bilgi için bkz . MSBuild özellikleri.

özellik dosyası

Özellik dosyası, çoğunlukla derlemeye yol gösteren özellik gruplarını ve öğe gruplarını içeren bir proje dosyasıdır. Kural gereği, .props dosya uzantısına sahiptir. Özellik dosyaları genellikle ilişkili proje dosyalarının başında içeri aktarılır.

özellik, işlev

Özellik işlevi, MSBuild betiklerini değerlendirmek için kullanılabilecek bir sistem özelliği veya yöntemidir. Özellik yöntemleri sistem saatini okumak, dizeleri karşılaştırmak, normal ifadeleri eşleştirmek ve diğer eylemleri gerçekleştirmek için kullanılabilir. Daha fazla bilgi için bkz . Özellik işlevleri.

özellik işlevi, iç içe

Özellik işlevleri daha karmaşık işlevler oluşturmak için birleştirilebilir. Örneğin,

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

Daha fazla bilgi için bkz . Özellik işlevleri.

özellik, genel

Genel özellik, derleme işlemini denetlemek için kullanılan bir anahtar-değer çiftidir. Genel özellikler bir komut isteminde veya MSBuild görevinin Propertiesözniteliği kullanılarak ayarlanır ve derlemenin değerlendirme aşamasında değiştirilemez. Daha fazla bilgi için bkz . MSBuild özellikleri.

özellik, yerel

Yerel özellik, derleme işlemini denetlemek için kullanılan bir anahtar-değer çiftidir. Bu terim yalnızca genel özellik olmayan bir özelliği ayırt etmek için kullanılır.

özellik, kayıt defteri

Kayıt defteri özelliği, sistem kayıt defteri alt anahtarının değerini okuyan özel bir söz dizimi kullanılarak ayarlanan bir değere sahiptir. Daha fazla bilgi için bkz . MSBuild özellikleri.

özellik, ayrılmış

Ayrılmış özellik, derleme işlemini denetlemek için kullanılan bir anahtar-değer çiftidir. Ayrılmış özellikler, önceden tanımlanmış değerlere otomatik olarak başlatılır. Daha fazla bilgi için bkz . MSBuild özellikleri.

proje kapsamı

Project-scope, yalnızca içeren proje dosyasında ve içeri aktardığı tüm projelerde görünen bir YEREL özellik gibi bir MSBuild nesnesini açıklar.

proje, alt öğe

Bir proje derlemesi sırasında MSBuild görevi tarafından bir alt proje oluşturulur. Bu yeni proje, MSBuild görevini içeren hedefi içeren veya içeri aktaran projenin alt öğesidir. Alt proje, özniteliği tarafından Properties değiştirilmedikleri sürece üst projenin genel özelliklerini devralır.

redist list

Yeniden dağıtım listesi: Belirli bir çerçeveye karşılık gelen derlemelerin listesi.

başvuru derlemesi

Bir uygulama oluşturmak için tasarım zamanında kullanılan derleme. Bir başvuru derlemesinde gerçek kod ve özel arabirimler kaldırılarak yalnızca meta veriler ve genel arabirimler bırakılabilir.

kayıt defteri özelliği

Bkz. özellik, kayıt defteri.

hedef

Hedef, görevleri belirli bir sırada gruplandırarak proje dosyasının bölümlerini derleme işlemine giriş noktaları olarak gösterir. Daha fazla bilgi için bkz . Hedefler.

hedef, bina

Bkz. hedef, çalışıyor.

hedef, değerlendirme

Artımlı derleme nedeniyle, özelliklerde ve öğelerde olası değişiklikler için hedefler analiz edilmelidir. Hedef atlanmış olsa bile, bu değişikliklerin yapılması gerekir. Hedefi değerlendirmek, bu analizi gerçekleştirmek ve bu değişiklikleri yapmak anlamına gelir. Daha fazla bilgi için bkz . Artımlı derlemeler.

hedef, yürütme

Hedefin yürütülmesi, hedefi değerlendirmek ve koşul içermeyen veya koşulları true olarak değerlendirilen tüm görevleri yürütmek anlamına gelir. Artımlı derleme sırasında hedefler atlanabilir veya yürütülebilir, ancak bunlar her zaman değerlendirilir. Daha fazla bilgi için bkz. hedef, değerlendirme.

hedef, çalışıyor

false sonucunu veren bir koşula sahip bir hedef çalıştırılmaz, yani derleme üzerinde hiçbir etkisi yoktur. Çalıştırılan hedefler yürütülür veya atlanır. Her iki durumda da hedef değerlendirilir. Daha fazla bilgi için bkz. hedef, değerlendirme.

hedef, atlanıyor

Artımlı derleme tüm çıkış dosyalarının güncel olduğunu belirlerse hedef atlanır, yani hedef değerlendirilir, ancak hedef içindeki görevler yürütülür. Daha fazla bilgi için bkz. hedef, değerlendirme.

hedef çerçeve adı

Çerçeveyi (gibi) açıklayan bir ad. NETFramework, Silverlight vb.), sürüm ve hedeflemek istediğiniz profil (İstemci, Sunucu vb.)

hedefleme paketi

Belirli bir çerçeveyle dağıtılan derlemelerin listesi ve bu çerçeve için başvuru derlemeleri kümesi.

targets dosyası

Hedefler dosyası, çoğunlukla derlemeye yol gösteren hedefleri ve görevleri içeren bir proje dosyasıdır. Kural gereği, .targets dosya uzantısına sahiptir. Hedef dosyalar genellikle ilişkili proje dosyalarının sonunda içeri aktarılır.

görev

Görevler, MSBuild projelerinin derleme işlemlerini gerçekleştirmek için kullandığı yürütülebilir kod birimleridir. Örneğin, bir görev giriş dosyalarını derlayabilir veya bir dış araç çalıştırabilir. Daha fazla bilgi için bkz . Görevler.

transform

Dönüşüm, bir öğe koleksiyonunun diğerine bire bir dönüştürülmesidir. Bir projenin öğe koleksiyonlarını dönüştürmesine olanak tanımanın yanı sıra, dönüştürme hedefin giriş ve çıkışlar arasında doğrudan eşleme tanımlamasını sağlar. Daha fazla bilgi için bkz . Dönüşümler.

iyi bilinen meta veriler

Bkz. meta veriler, iyi bilinen.

Ayrıca bkz.