Sdílet prostřednictvím


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

Obecně doporučujeme, abyste pomocí sady Visual Studio nastavili vlastnosti projektu a vyvolali systém MSBuild. Nástroj MSBuild však můžete použít přímo z příkazového řádku. Proces sestavení se řídí informacemi v souboru projektu (.vcxproj), který můžete 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 ]

Pomocí možností příkazového řádku /target (nebo /t) a /property (nebo /p) můžete přepsat konkrétní vlastnosti a cíle zadané v souboru projektu.

Základní funkcí souboru projektu je určení cíle, což je konkrétní operace použitá pro váš projekt, a vstupy a výstupy potřebné k provedení této operace. Soubor projektu může zadat jeden nebo více cílů, které můžou obsahovat výchozí cíl.

Každý cíl se skládá z posloupnosti jednoho nebo více úkolů. Každá úloha je reprezentována třídou rozhraní .NET Framework, která obsahuje jeden spustitelný příkaz. Úloha CL například obsahuje příkaz cl.exe.

Parametr úlohy je vlastnost úlohy třídy a 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 /Os a /Ot .

Další parametry úkolů podporují infrastrukturu NÁSTROJE MSBuild. Například Sources parametr úkolu určuje sadu úkolů, které mohou být spotřebovány jinými úkoly. Další informace o úlohách NÁSTROJE MSBuild naleznete v tématu Referenční dokumentace k úkolu.

Většina úloh vyžaduje vstupy a výstupy, jako jsou názvy souborů, cesty a řetězce, číselné nebo logické parametry. Běžným vstupem je například název .cpp zdrojového souboru, který se má zkompilovat. Důležitým vstupním parametrem je řetězec, který určuje konfiguraci sestavení a platformu, například "Debug|Win32". Vstupy a výstupy jsou určeny jedním nebo více uživatelem definovaných elementů XML Item obsažených v elementu ItemGroup .

Soubor projektu může také určovat uživatelem definované vlastnosti a ItemDefinitionGroup položky. Vlastnosti a páry název/hodnota formuláře, které lze použít jako proměnné v sestavení. Komponenta názvu páru definuje makro a komponenta hodnoty deklaruje hodnotu makra. K makr vlastnosti se přistupuje pomocí zápisu $(name) a k makrové položce se přistupuje pomocí notace %(name).

Ostatní elementy XML v souboru projektu mohou testovat makra a podmíněně nastavit hodnotu libovolného makra nebo řídit provádění sestavení. Názvy maker a literály lze zřetězením vytvořit konstruktory, jako je cesta a název souboru. Na příkazovém řádku nastaví možnost /vlastnost nebo přepíše vlastnost projektu. Na příkazový řádek nelze odkazovat.

Systém MSBuild 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, jestli jsou soubory, které cíl využívá, novější než soubory, které generuje.

Další informace o nástroji MSBuild najdete tady:

V tomto oddílu

Pojem definice
Návod: Vytvoření projektu C++ pomocí nástroje MSBuild Ukazuje, jak vytvořit projekt visual studio C++ pomocí nástroje MSBuild.
Postupy: Použití událostí sestavení v projektech MSBuild Ukazuje, jak určit akci, která se vyskytuje ve fázi particuler v sestavení: před zahájením sestavení; před zahájením kroku propojení; nebo po skončení sestavení.
Postupy: Přidání vlastního kroku sestavení do projektů MSBuild Ukazuje, jak přidat uživatelem definovanou fázi do sekvence sestavení.
Postupy: Přidání vlastních nástrojů sestavení do projektů MSBuild Ukazuje, jak přidružit nástroj sestavení k určitému souboru.
Postupy: Integrace vlastních nástrojů do vlastností projektu Ukazuje, jak přidat možnosti vlastního nástroje do vlastností projektu.
Postupy: Změna cílové architektury a sady nástrojů Ukazuje, jak zkompilovat projekt pro více architektur nebo sad nástrojů.

Viz také

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