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á.