Sdílet prostřednictvím

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 .

Parametry úlohy slouží k podpoře infrastruktury 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 MSBuild naleznete v referenčním přehledu úloh Task Reference.

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 ItemDefinitionGrouppoložky. Vlastnosti a název/hodnota páry tvoří, které lze použít jako proměnné v kompilaci. Komponenta názvu páru definuje makro a komponenta hodnoty deklaruje hodnotu makra. K makru vlastnosti se přistupuje pomocí zápisu $(name) a k položce makra se přistupuje pomocí zápisu %(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 řetězce lze zřetězením vytvořit konstrukty, jako je cesta a název souboru. Na příkazovém řádku nastaví možnost /vlastnost vlastnost projektu nebo ji přepíše. Položky nelze odkazovat na příkazovém řádku.

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 v konkrétní fázi sestavení: před zahájením sestavení; před zahájením kroku spojení; nebo po skončení sestavení.
Návod: 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

  • Last updated on