MSBuild na příkazovém řádku – C++

obecně doporučujeme použít Visual Studio k nastavení vlastností projektu a vyvolání MSBuild systému. nástroj MSBuild však můžete použít přímo z příkazového řádku. Proces sestavení je řízen informacemi v souboru projektu (. vcxproj), které lze vytvořit a upravit. Soubor projektu určuje možnosti sestavení na základě fází sestavení, podmínek a událostí. Kromě toho můžete zadat nula nebo více argumentů možností příkazového řádku.

msbuild.exe [ project_file ] [ Možnosti ]

Použijte možnosti příkazového řádku /target (nebo /t) a /Property (nebo /p) k přepsání specifických vlastností a cílů, které jsou zadány v souboru projektu.

Základní funkcí souboru projektu je určit cíl, který je konkrétní operací použitým pro váš projekt, a vstupy a výstupy, které jsou nutné k provedení této operace. Soubor projektu může určit jeden nebo více cílů, které mohou zahrnovat výchozí cíl.

Každý cíl se skládá z posloupnosti jednoho nebo více úloh. jednotlivé úlohy jsou reprezentovány .NET Framework třídou, která obsahuje jeden spustitelný příkaz. Například úloha CL obsahuje příkaz cl.exe .

Parametr Task je vlastnost úlohy třídy, která obvykle představuje možnost příkazového řádku spustitelného příkazu. Například FavorSizeOrSpeed parametr CL úlohy odpovídá možnostem kompilátoru FavorSizeOrSpeed a CL .

další parametry úlohy podporují infrastrukturu MSBuild. Například Sources parametr Task určuje sadu úloh, které mohou být spotřebovány jinými úkoly. další informace o MSBuildch úlohách naleznete v tématu task Reference.

Většina úloh vyžaduje vstupy a výstupy, jako jsou názvy souborů, cesty a řetězcové, číselné nebo logické parametry. Například běžným vstupem je název zdrojového souboru. cpp ke kompilaci. Důležitý vstupní parametr je řetězec, který určuje konfiguraci sestavení a platformu, například "ladit | Win32 ". Vstupy a výstupy jsou určené jedním nebo více uživatelsky definovanými Item prvky XML obsaženými v ItemGroup elementu.

Soubor projektu může také určit uživatelem definované vlastnosti a položky. Vlastnosti a položky ve formě dvojice název/hodnota, které lze použít jako proměnné v sestavení. Název komponenty páru definuje makroa komponenta Value deklaruje hodnotu makra. K makru vlastnosti se dostanete pomocí zápisu $ (Name) a k makru položky se dostanete pomocí%(Name).

Jiné prvky XML v souboru projektu mohou testovat makra a následně podmíněně nastavit hodnotu jakéhokoli makra nebo řídit spuštění sestavení. Názvy maker a řetězcové literály lze zřetězit, aby bylo možné generovat konstrukce, jako je například cesta a název souboru. V příkazovém řádku možnost /Property nastaví nebo přepíše vlastnost projektu. Na příkazový řádek nelze odkazovat na položky.

MSBuild systém může podmíněně spustit cíl před nebo po jiném cíli. Systém může také vytvořit cíl na základě toho, zda soubory, které cíl využívá, jsou novější než soubory, které posílá.

další informace o MSBuild najdete v tématech:

• MSBuild přehled konceptů MSBuild.

• MSBuild referenční informace o MSBuild systému.

• Project odkaz na schéma souborů obsahuje seznam MSBuild prvků schématu XML spolu s jejich atributy a nadřazenými a podřízenými prvky. Obzvláště Poznamenejte si prvky Item, Property, targeta Task .

• Reference k příkazovému řádku Popisuje argumenty příkazového řádku a možnosti, které můžete použít s msbuild.exe.

• Odkaz na úkol popisuje MSBuild úlohy. Zvláště si všimněte těchto úkolů, které jsou specifické pro Visual C++: BSCMAKE Task, CL, CPPClean – Task, lib Task, propojování Task, Task MIDL, Mt Task, RCTask, setenv – Task, VCMessage – Task

V tomto oddílu

Viz také

Použití sady nástrojů MSVC z příkazového řádku