Sdílet prostřednictvím

Referenční dokumentace pro použití nástroje MSBuild v příkazovém řádku

  • Článek

Použijete-li vytvořit soubor projektu nebo řešení MSBuild.exe, můžete přidat několik přepínačů, chcete-li určit různé aspekty procesu.

MSBuild.exe [Switches] [ProjectFile]

Arguments

Argument

Popis

ProjectFile

Sestaví cílům v souboru projektu, který zadáte.Pokud nezadáte soubor projektu, prohledá MSBuild aktuálního pracovního adresáře pro příponu názvu souboru, který končí řetězcem "proj" a použije tento soubor.Můžete také určit Visual Studio soubor řešení pro tento argument.

Přepínače

Přepínač

Krátký tvar

Popis

/help

/?nebo /h

Zobrazit informace o použití.Následující příkaz je příklad:

msbuild.exe /?

/detailedsummary

/DS

Zobrazit podrobné informace na konci protokolu sestavení o konfigurace, které byly vytvořeny a jak bylo naplánováno do uzlů.

/ignoreprojectextensions:extensions

/ Ignorovat.extensions

Určení, jaký soubor projektu sestavení, ignorujte zadaným rozšířením.Pomocí středníkem nebo čárky k oddělení více přípon, jak ukazuje následující příklad:

/ignoreprojectextensions:.vcproj,.sln

/maxcpucount [:number]

/m[:number]

Určuje maximální počet souběžných procesů, které má být použit při vytváření.Pokud nezadáte tento přepínač, výchozí hodnota je 1.Pokud použijete tento přepínač bez zadání hodnoty, bude MSBuild použít až počet procesorů v počítači.Další informace naleznete v tématu Paralelní sestavování více projektů současně pomocí nástroje MSBuild.

Následující příklad nastaví MSBuild vytvářet pomocí tři MSBuild procesy, což umožňuje vytvářet současně tři projekty:

msbuild myproject.proj /maxcpucount:3

/noautoresponse

/noautorsp

Nezadávejte žádné soubory MSBuild.rsp automaticky.

/nodeReuse:value

/nr:value

Povolit nebo zakázat opakované použití MSBuild uzlů.Můžete zadat následující hodnoty:

  • Hodnota TRUE.Uzly zůstat po dokončení sestavení, takže následné sestavení můžete použít (výchozí).

  • False.Uzly není zůstat po dokončení sestavení.

Uzel odpovídá projektu, která je spuštěna.Zadáte-li /maxcpucount přepínače, více uzlů lze současně provést.

/nologo

Nezobrazovat úvodní nápis nebo zprávu o autorských právech.

/ Předběžně zpracovat [:filepath]

/pp[:filepath]

Vytvořte soubor projektu jeden, agregovaný podle vkládání všechny soubory, které by byl importován během sestavení, s jejich hranice označena.Tento přepínač lze snadněji určit soubory, které jsou importována, kde jsou importována soubory a které soubory přispívají k sestavení.Použijete-li tento přepínač, není založen na projekt.

Pokud zadáte filepath, soubor agregované projektu je výstup do souboru.V opačném výstupu se zobrazí v okně konzoly.

Informace o tom, jak používat Import elementu, který chcete vložit soubor projektu do jiného souboru projektu, naleznete v části Import – element (MSBuild) a Postupy: Použití stejného cíle ve více souborech projektu.

/Property:name=value

/p:name=value

Nastavení nebo přepsání zadané vlastnosti úrovni projektu, kde name je název vlastnosti a value je hodnota vlastnosti.Zadat každou vlastnost zvlášť, nebo použijte středníkem nebo čárkami k oddělení více vlastností, jak ukazuje následující příklad:

/property:WarningLevel=2;OutDir=bin\Debug

/ target:targets

/ t:targets

Vytvářejte zadaného cíle v projektu.Každý cíl zadat zvlášť, nebo použijte středníkem nebo čárkami k oddělení více cíle, jak ukazuje následující příklad:

/target:Resources;Compile

Pokud zadáte jakékoli cíle pomocí tohoto přepínače, jsou spouštěny namísto jakékoli cíle v DefaultTargets atribut v souboru projektu.Další informace naleznete v tématu Pořadí sestavení cílů a Postupy: Určení prvního cíle k sestavení.

Cíl je skupina úlohy.Další informace naleznete v tématu Cíle nástroje MSBuild.

/toolsversion:version

/TV:version

Určuje verzi sadu nástrojů, které má být použit k sestavení projektu, jak ukazuje následující příklad:/toolsversion:3.5

Pomocí tohoto přepínače můžete sestavování projektu a zadat verzi, která se liší od verze, která je zadána v Project – element (MSBuild).Další informace naleznete v tématu Přepsání nastavení parametru ToolsVersion.

Pro MSBuild 4.5, můžete určit následující hodnoty version: 2.0, 3.5 a 4.0.Pokud zadáte 4.0, VisualStudioVersion sestavení vlastnost určuje, jaké sub-sadu nástrojů používat.Další informace naleznete v části Sub modulové Sada nástrojů MSBuild (atribut ToolsVersion).

Sadu nástrojů se skládá z úkoly, cíle a nástroje, které se používají k sestavení aplikace.Tyto nástroje zahrnují například csc.exe a vbc.exe kompilátorů.Další informace o modulové naleznete v tématu Sada nástrojů MSBuild (atribut ToolsVersion), Standardní a vlastní konfigurace sady nástrojů, a Přehled cílení na více verzí nástroje MSBuild.

[!POZNÁMKA]

Verze sady nástrojů není stejná jako cílové rozhraní, což je verze rozhraní .NET Framework, na kterém je založena na projektu ke spuštění.Další informace naleznete v tématu Cílová architektura a cílová platforma nástroje MSBuild.

/ ověření: [schema]

/val[schema]

Ověřit soubor projektu a v případě úspěšného ověření sestavení projektu.

Pokud neurčíte schema, projekt, který je porovnávána s výchozí schéma.

Pokud zadáte schema, projekt, který je porovnávána s schématu, který zadáte.

Následující nastavení je příklad:/validate:MyExtendedBuildSchema.xsd

/verbosity:level

/ v:level

Určuje dobu, po kterou informace zobrazené v protokolu sestavení.Každý protokolovacího nástroje zobrazuje události, které jsou založeny na úroveň podrobností, kterou jste nastavili pro tohoto protokolovacího nástroje.

Můžete zadat následující úrovně podrobností: q[uiet], m[inimal], n[ormal], d[etailed], a diag[nostic].

Následující nastavení je příklad:/verbosity:quiet

/Version

/ ver

Zobrazit informace o verzi.Projekt, který není založen.

@file

Vložte přepínače příkazového řádku z textového souboru.Pokud máte více souborů, můžete je zadat samostatně.Další informace naleznete v tématu Soubory odezvy nástroje MSBuild.

Přepínače protokolovacích nástrojů

Přepínač

Krátký tvar

Popis

/consoleloggerparameters:

parameters

/CLP:parameters

Předejte parametry, které zadáte do konzoly protokolovacího nástroje, které zobrazuje informace o sestavení v okně konzoly.Můžete zadat následující parametry:

  • PerformanceSummary.Zobrazení času stráveného v úkoly, cíle a projekty.

  • Souhrn.Zobrazte chyby a upozornění shrnutí na konci.

  • NoSummary.Na konci není zobrazení chyb a upozornění shrnutí.

  • ErrorsOnly.Zobrazit pouze chyby.

  • WarningsOnly.Zobrazit pouze upozornění.

  • NoItemAndPropertyList.Nezobrazovat seznam položek a vlastnosti, které se mají zobrazit na začátku každé sestavení projektu, pokud úroveň podrobností je nastaven na diagnostic.

  • ShowCommandLine.Zobrazit TaskCommandLineEvent zprávy.

  • ShowTimestamp.Zobrazit časové razítko jako předpona, která má všechny zprávy.

  • ShowEventId.Zobrazit ID události pro každý Začínáme událostí, dokončené události a zprávy.

  • ForceNoAlign.Není zarovnání textu velikost vyrovnávací paměti konzoly.

  • DisableConsoleColor.Pomocí konzoly výchozí barvy pro všechny zprávy protokolování.

  • DisableMPLogging.Při spuštění v režimu s více procesory, zakažte víceprocesorový protokolování styl výstupu.

  • EnableMPLogging.Styl víceprocesorový protokolování povolte, i v případě, že je spuštěn v režimu s více procesory.Ve výchozím nastavení je tento styl protokolování na.

  • Podrobností.Přepsání /verbosity nastavení pro protokolovacího nástroje.

Použijte středníkem nebo čárkami k oddělení více parametrů, jak ukazuje následující příklad:

/consoleloggerparameters:PerformanceSummary;NoSummary /verbosity:minimal

/distributedFileLogger

/DFL

Do vlastní soubor protokolu každý uzel MSBuild výstupu sestavení.Počáteční umístění pro tyto soubory je aktuální adresář.Ve výchozím nastavení jsou soubory s názvem "MSBuildNodeIdlog".Můžete použít /fileLoggerParameters přepínač, který určuje umístění souborů a dalších parametrů pro fileLogger.

Pokud název souboru protokolu pomocí /fileLoggerParameters přepínače, distribuované protokolovacího nástroje bude použít jej jako šablonu zadejte název a připojit ID uzlu tohoto názvu při vytváření souboru protokolu pro každý uzel.

/distributedlogger:

central logger*

forwarding logger

/dl:central logger*forwarding logger

Protokol událostí z MSBuild, pro každý uzel připojení instance různé protokolovacího nástroje.Pokud chcete zadat více protokolovačů, zadejte zvlášť každý protokolovacího nástroje.

K určení protokolovací nástroj použijete syntaxi protokolovacího nástroje.Syntaxi protokolovacího nástroje naleznete v tématu /logger přepínač níže.

Následující příklady ukazují, jak používat tento přepínač:

/dl:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral

/dl:MyLogger,C:\My.dll*ForwardingLogger,C:\Logger.dll

/fileLogger

[číslo]

/fl[number]

Protokolovat výstupu sestavení do jednoho souboru v aktuálním adresáři.Pokud neurčíte number, výstupní soubor je s názvem msbuild.log.Pokud zadáte number, výstupní soubor se nazývá msbuildnlog, kde n je number.Numberje možné číslici od 1 do 9.

Můžete použít /fileLoggerParameters přepínač, chcete-li určit umístění souboru a dalších parametrů pro fileLogger.

/fileloggerparameters: [číslo]

parameters

/flp:[ number]parameters

Určuje žádné další parametry pro protokolovacího nástroje souborů a souborů DFS protokolovacího nástroje.Přítomnost tento přepínač vyplývá, že odpovídající /filelogger[number] přepínač je k dispozici.Numberje možné číslici od 1 do 9.

Můžete použít všechny parametry, které jsou uvedeny pro /consoleloggerparameters.Můžete také jednu nebo více z následujících parametrů:

  • Soubor protokolu.Cesta k souboru protokolu, do kterého je zapsán protokolu sestavení.Protokolování souborů DFS zadání předpony tuto cestu na názvy souborů protokolu.

  • Připojit.Určuje, zda protokolu sestavení je připojen k souboru protokolu přepíše ji.Pokud nastavíte přepínače, protokolu sestavení je připojen k souboru protokolu.Pokud přepínač není k dispozici, budou přepsány obsah existujícího souboru protokolu.

    Je-li zahrnout přepínač připojit bez ohledu na to, zda je nastaven na hodnotu true nebo false, je připojen do protokolu.Pokud nezadáte přepínač připojení, je přepsán do protokolu.

    V takovém případě je soubor přepsán:msbuild myfile.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log

    V takovém případě je přidáván souboru:msbuild myfile.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log;append=true

    V takovém případě je přidáván souboru:msbuild myfile.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log;append=false 

  • Kódování.Určuje kódování souboru (například UTF-8, Unicode nebo ASCII).

Následující příklad generuje samostatné soubory protokolu pro upozornění a chyby:

/flp1:logfile=errors.txt;errorsonly /flp2:logfile=warnings.txt;warningsonly

Následující příklady ukazují další možnosti:

/fileLoggerParameters:LogFile=MyLog.log;Append; Verbosity=diagnostic;Encoding=UTF-8

/flp:Summary;Verbosity=minimal;LogFile=msbuild.sum

/flp1:warningsonly;logfile=msbuild.wrn

/flp2:errorsonly;logfile=msbuild.err

/Logger:

logger

l:logger

Určuje protokolovacího nástroje pro použití k protokolování událostí z MSBuild.Pokud chcete zadat více protokolovačů, zadejte zvlášť každý protokolovacího nástroje.

Pomocí následující syntaxe pro logger:[LoggerClass,]LoggerAssembly[;LoggerParameters]

Pomocí následující syntaxe pro LoggerClass:[PartialOrFullNamespace.]LoggerClassName

Nemáte k určení třídy protokolovacího nástroje, pokud sestavení obsahuje přesně jeden protokolovacího nástroje.

Pomocí následující syntaxe pro LoggerAssembly:{AssemblyName[,StrongName] | AssemblyFile}

Parametry protokolovacího nástroje jsou volitelné a přesně tak, jak je zadat předáno protokolovacího nástroje.

Následující příklady používají /logger přepnout.

/logger:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral

/logger:XMLLogger,C:\Loggers\MyLogger.dll;OutputAsHTML

/noconsolelogger

/noconlog

Zakázat protokolovacího nástroje konzoly výchozí a není protokolovat události do konzoly.

Příklad

Následující příklad sestavení rebuild cíl MyProject.proj projektu.

MSBuild.exe MyProject.proj /t:rebuild

MSBuild.exe můžete provádět složitější sestavení.Například můžete použít k sestavení zvláštní cíle konkrétní projekty v řešení.Následující příklad znovu vytvoří projekt NotInSolutionFolder a vyčistí projektu InSolutionFolder, který je v NewFolder složku řešení.

msbuild SlnFolders.sln /t:NotInSolutionfolder:Rebuild;NewFolder\InSolutionFolder:Clean

Viz také

Referenční dokumentace

Obecné vlastnosti projektu nástroje MSBuild

Další zdroje

Referenční dokumentace nástroje MSBuild