Slovníček nástroje MSBuild

Tyto termíny slouží k popisu modulu Microsoft Build Engine (MSBuild) a jeho součástí.

AssemblyFoldersEx

Umístění registru, kde dodavatelé třetích stran ukládají cesty pro každou verzi architektury, kterou podporují, kde řešení času návrhu může hledat referenční sestavení.

dávkování

Dávkování znamená rozdělení položek do různých kategorií označovaných jako dávky na základě metadat položek a následné spuštění cíle nebo úkolu jednou pomocí každé dávky. Dávkování je ekvivalentem msBuild konstruktoru for-loop. Další informace najdete v tématu Dávkování.

rozsah sestavení

Obor sestavení popisuje objekt MSBuild, například globální vlastnost, která je potenciálně viditelná pro projekt a pro všechny podřízené projekty vytvořené v sestavení s více projekty.

podřízený projekt

Viz projekt, podřízený.

condition

Mnoho elementů MSBuild lze definovat podmíněně; to znamená, že Condition atribut se zobrazí v elementu. Obsah podmíněných prvků se ignoruje, pokud se podmínka nehodnotí jako true. Další informace naleznete v tématu Podmínky.

definice, položka

Viz definice položky.

vygenerovat položku

Během fáze provádění sestavení lze položky vytvářet nebo upravovat úkoly, které mají podřízené Output prvky, které mají ItemName atribut. Úkol je označen jako "vygenerovat" nové položky.

emit – vlastnost

Během fáze provádění sestavení lze vlastnosti vytvářet nebo upravovat úkoly, které mají podřízené Output prvky, které mají PropertyName atribut. Úkol se říká, že má "vygenerovat" novou vlastnost.

fáze vyhodnocení

Vyhodnocení je první fáze sestavení projektu. Všechny vlastnosti a položky se vyhodnocují v pořadí, ve kterém se zobrazují v projektu. Importované projekty se vyhodnocují tak, jak jsou v projektu zjištěny. Cíle a úlohy se nespustí do fáze provádění a všechny vlastnosti nebo položky, které by deklarovaly nebo vygenerovaly, se během vyhodnocení ignorují.

fáze provádění

Provádění je druhá fáze sestavení projektu. Vybrané cíle jsou vytvořené a úkoly se spouštějí. Vlastnosti a položky lze vytvořit nebo upravit v porovnání s jejich hodnotami vyhodnocení.

function, property

Viz funkce vlastnosti.

function, item

Viz funkce item.

položka

Položky jsou vstupy do systému sestavení a jsou seskupené do typů položek na základě jejich názvů prvků. Položky obvykle představují soubory. Vzhledem k tomu, že položky jsou pojmenované podle typu položky, do které patří, lze zaměnitelně. Další informace naleznete v tématu Položky.

definice položky

Skupiny definic položek obsahují definice položek, které přidávají výchozí metadata k libovolnému typu položky. Stejně jako dobře známá metadata jsou výchozí metadata přidružená ke všem položkám zadaného typu položky. Výchozí metadata lze explicitně přepsat v definici položky. Další informace naleznete v tématu Definice položek.

item – funkce

Funkce položek získávají informace o položkách v projektu. Tyto funkce zjednodušují získávání položek Distinct() a jsou rychlejší než smyčky mezi položkami. Existují funkce pro manipulaci s cestami položek a řetězci. Další informace naleznete v tématu Funkce položky.

metadata položky

Viz metadata, položka.

typ položky

Typy položek jsou pojmenované seznamy položek, které lze použít jako parametry pro úkoly. Úkoly používají hodnoty položek k provedení kroků procesu sestavení. Další informace naleznete v tématu Položky.

metadata, položka

Metadata položky jsou kolekce dvojic název-hodnota, které jsou přidruženy k položce. Metadata poskytují popisné informace o položce a jsou nepovinná, s výjimkou dobře známých metadat. Další informace naleznete v tématu Položky.

metadata, dobře známá

Známá metadata jsou metadata položek jen pro čtení, která jsou inicializována pomocí předdefinované hodnoty. Dobře známá metadata poskytují popisné informace pro položku, která odkazuje na soubor. Například hodnota dobře známých metadat s názvem FullPath je úplná cesta odkazovaného souboru. Další informace naleznete v tématu Položky.

cílení na více verzí

Schopnost projektu aplikace nebo sestavení cílit na mnoho různých architektur CLR od MSBuild a ze sady Visual Studio.

profil

Podmnožina celé architektury. Používá se k minimalizaci množství, které je potřeba stáhnout do počítače.

soubor projektu

Soubor projektu obsahuje skript MSBuild, který řídí sestavení. Soubory projektu mají obvykle příponu souboru, která končí proj, například .csproj nebo .vbproj. Soubory projektu mohou importovat soubory vlastností a cílové soubory.

vlastnost

Vlastnost je pár klíč-hodnota, který slouží k řízení procesu sestavení. Další informace naleznete v tématu MSBuild vlastnosti.

vlastnost, prostředí

Vlastnost prostředí je vlastnost, která se automaticky inicializuje na hodnotu systémové proměnné prostředí, která má stejný název. Další informace naleznete v tématu MSBuild vlastnosti.

soubor vlastností

Soubor vlastností je soubor projektu, který obsahuje převážně skupiny vlastností a skupiny položek, které provedou sestavení. Podle konvence má příponu souboru .props. Soubory vlastností se obvykle importují na začátku přidružených souborů projektu.

property, function

Funkce vlastnosti je systémová vlastnost nebo metoda, kterou lze použít k vyhodnocení skriptů MSBuild. Metody vlastností lze použít ke čtení systémového času, porovnávání řetězců, porovnávání regulárních výrazů a provádění dalších akcí. Další informace naleznete v tématu Funkce vlastností.

funkce vlastností, vnořená

Funkce vlastností mohou být kombinovány tak, aby vytvořily složitější funkce. Příklad:

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

Další informace naleznete v tématu Funkce vlastností.

vlastnost, globální

Globální vlastnost je pár klíč-hodnota, který slouží k řízení procesu sestavení. Globální vlastnosti jsou nastaveny na příkazovém řádku nebo pomocí Properties atributu úlohy MSBuild a nelze je změnit během zkušební fáze sestavení. Další informace naleznete v tématu MSBuild vlastnosti.

vlastnost, místní

Místní vlastnost je pár klíč-hodnota, který slouží k řízení procesu sestavení. Tento termín slouží pouze k rozlišení vlastnosti, která není globální vlastností.

vlastnost, registr

Vlastnost registru má hodnotu nastavenou pomocí speciální syntaxe, která čte hodnotu podklíče systémového registru. Další informace naleznete v tématu MSBuild vlastnosti.

vlastnost, rezervovaná

Rezervovaná vlastnost je pár klíč-hodnota, který slouží k řízení procesu sestavení. Rezervované vlastnosti se automaticky inicializují na předdefinované hodnoty. Další informace naleznete v tématu MSBuild vlastnosti.

rozsah projektu

Obor projektu popisuje objekt MSBuild, například místní vlastnost, která je viditelná pouze v obsahujícím souboru projektu a pro všechny projekty, které importuje.

projekt, podřízený

Podřízený projekt je vytvořen úlohou MSBuild během sestavení projektu. Tento nový projekt je podřízený projekt, který obsahuje nebo importuje cíl, který obsahuje úlohu MSBuild. Podřízený projekt dědí globální vlastnosti nadřazeného projektu, pokud nejsou upraveny atributem Properties .

seznam redist

Seznam redistribucí: seznam sestavení, která odpovídají danému rozhraní.

referenční sestavení

Sestavení, které se používá během návrhu k vytvoření aplikace. Referenční sestavení může mít vlastní kód a privátní rozhraní odebraná z něj a ponechat pouze metadata a veřejná rozhraní.

vlastnost registru

Viz vlastnost, registr.

target

Cíl seskupí úkoly dohromady v určitém pořadí a zpřístupní oddíly souboru projektu jako vstupní body do procesu sestavení. Další informace naleznete v tématu Cíle.

target, building

Viz cíl, spuštěno.

cíl, vyhodnocení

Z důvodu přírůstkové kompilace musí být cíle analyzovány z hlediska potenciálních změn vlastností a položek. I když je cíl vynechán, musí se tyto změny provést. Vyhodnocení cíle znamená provedení této analýzy a provedení těchto změn. Další informace naleznete v tématu Přírůstkové sestavení.

target, executing

Spuštění cíle znamená vyhodnocení a provádění všech úloh, které nemají žádné podmínky nebo jejichž podmínky jsou vyhodnoceny jako pravdivé. Během přírůstkové kompilace můžou být cíle vynechány nebo spouštěny, ale vždy se vyhodnocují. Další informace najdete v tématu cíl, vyhodnocení.

target, running

Cíl, který má podmínku, která se vyhodnotí jako nepravda, se nespustí, to znamená, že na sestavení nemá žádný vliv. Cíle, které se spustí, nebo se přeskočí. V obou případech se cíl vyhodnotí. Další informace najdete v tématu cíl, vyhodnocení.

cíl, přeskočení

Pokud přírůstková kompilace určuje, že všechny výstupní soubory jsou aktuální, cíl se přeskočí, tj. cíl se vyhodnotí, ale úkoly v rámci cíle se nespustí. Další informace najdete v tématu cíl, vyhodnocení.

Moniker cílové architektury

Název, který popisuje architekturu (například . NETFramework, Silverlight atd.), verze a profil (například Klient, Server atd.), na který chcete cílit.

cílová sada

Seznam sestavení distribuovaných s danou architekturou a sadu referenčních sestavení pro danou architekturu.

targets file

Soubor cíle je soubor projektu, který obsahuje převážně cíle a úkoly, které vedou sestavení. Podle konvence má příponu souboru .targets. Cílové soubory se obvykle importují na konci přidružených souborů projektu.

úkol

Úlohy jsou jednotky spustitelného kódu, které projekty MSBuild používají k provádění operací sestavení. Úloha může například zkompilovat vstupní soubory nebo spustit externí nástroj. Další informace najdete v tématu Úkoly.

transform

Transformace je převod kolekce položek 1:1 na druhou. Kromě povolení projektu převádět kolekce položek transformace umožňuje cíli identifikovat přímé mapování mezi vstupy a výstupy. Další informace najdete v tématu Transformace.

dobře známá metadata

Viz metadata, dobře známá.

Viz také

• MSBuild