Share via

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ůže obsahovat několik přepínačů, chcete-li určit různé aspekty procesu.

MSBuild.exe [Switches] [ProjectFile]

Arguments

Argument

Description

ProjectFile

Vytvoří cíle v souboru projektu, který zadáte.Pokud nezadáte soubor projektu, MSBuild prohledá aktuální pracovní adresář pro příponu názvu souboru, který končí "proj" a používá 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

Description

/help

/?nebo /h

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

msbuild.exe /?

/detailedsummary

/DS

Zobrazit podrobné informace na konci protokolu sestavení konfigurace, které byly postaveny a jak byly naplánovány na uzly.

/ignoreprojectextensions:extensions

/ Ignorovat.extensions

Při určování, které soubor projektu k vytvoření, ignorujte zadané rozšíření.Použití středníku 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ů při sestavování.Pokud nechcete zahrnout tento přepínač, výchozí hodnota je 1.Pokud zahrnete tento přepínač bez zadání hodnoty, bude nástroj 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í nástroj MSBuild sestavení pomocí tří MSBuild procesy, což umožňuje tři projekty, které mají sestavit současně:

msbuild myproject.proj /maxcpucount:3

přepínač /

/noautorsp

Všechny MSBuild.rsp soubory nejsou zahrnuty automaticky.

/nodeReuse:value

/nr:value

Povolení nebo zakázání opětovného použití nástroje MSBuild uzlů.Můžete zadat následující hodnoty:

  • True.Uzly zůstávají po dokončení sestavení, takže následná sestavení můžete použít (výchozí).

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

Uzel odpovídá projektu, který je prováděn.Pokud zahrnete /maxcpucount přepínač, více uzly mohou být spuštěny souběžně.

/nologo

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

/ preprocess [:filepath

/pp[:filepath

Vytvořit soubor projektu jednotného, agregované podle vkládání všechny soubory, které bude importován během sestavení, s jejich hranice označeny.Tento přepínač lze snadněji určit soubory, které jsou dováženy, kde jsou importované soubory a které soubory přispívají k sestavení.Použijete-li tento přepínač, nejsou vytvořeny projektu.

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

Informace o použití Import element do souboru projektu vložit do jiného souboru projektu, viz Prvek importu (MSBuild) a Jak: použití stejného cíle ve více souborech projektu.

/Property:name=value

/p:name=value

Nastavit nebo změnit zadané vlastnosti na úrovni projektu, kde name je název vlastnosti a value je hodnota vlastnosti.Určit jednotlivé vlastnosti samostatně nebo použití středníku nebo čárky k oddělení více vlastností, jako v následujícím příkladu:

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

/ target:targets

/ t:targets

Vytvoření blíže určených konkrétních cílů v projektu.Každý cíl zadat samostatně nebo použití středníku nebo čárky k oddělení více cílů, jak ukazuje následující příklad:

/target:Resources;Compile

Pomocí tohoto přepínače zadáte všechny cíle, jsou spouštěny místo všech cílů v DefaultTargets atribut v souboru projektu.Další informace naleznete v tématu Cíl sestavení objednávky a Jak: Určete, které cíl nejprve sestavení.

Cíl je skupina úlohy.Další informace naleznete v tématu Nástroj MSBuild cíle.

/toolsversion:version

/TV:version

Určuje číslo verze sady nástrojů použít k sestavení projektu, jak ukazuje následující příklad:/toolsversion:3.5

Pomocí tohoto přepínače můžete sestavit projekt a určit verzi, která se liší od verze, která je zadána v Prvek projektu (MSBuild).Další informace naleznete v tématu Přepsání nastavení ToolsVersion.

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

Sady nástrojů obsahuje úkoly, cíle a nástroje, které se používají k vytváření aplikací.Nástroje obsahují kompilátory například csc.exe a vbc.exe.Další informace o modulové viz Sada nástrojů MSBuild (atribut ToolsVersion), Standardní a vlastní konfigurace sady nástrojů, a Přehled Multitargeting MSBuild.

PoznámkaPoznámka
Verze sady nástrojů není stejné jako cílové rozhraní, což je verze rozhraní.NET Framework, ve kterém je projekt sestaven pro spuštění.Další informace naleznete v tématu Nástroj MSBuild cílový rámec a cílová platforma.

/ validate: schema

/valschema

Ověření souboru projektu a je-li ověření úspěšné, sestavení projektu.

Nezadáte-li schema, projekt je porovnávána s výchozí schéma.

Zadáte-li schema, projekt je ověřen podle schématu, který zadáte.

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

/verbosity:level

/ v:level

Určuje množství informací, které chcete zobrazit v protokolu sestavení.Každý logger zobrazuje události, které jsou založeny na úroveň podrobností je nastavený tímto 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 uveden příklad:/verbosity:quiet

/version

/ ver

Zobrazí informace o verzi.Projekt nejsou vytvořeny.

@file

Vložení 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 odpovědí MSBuild.

ms164311.collapse_all(cs-cz,VS.110).gifPřepínače pro zaznamenávání stisknutých

Přepínač

Krátký tvar

Description

/consoleloggerparameters:parameters

/CLP:parameters

Předáte parametry, které zadáte do protokolovacího nástroje konzoly, 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.Příště zobrazit chyby a upozornění shrnutí na konci.

  • ErrorsOnly.Zobrazte pouze záznamy o chybách.

  • WarningsOnly.Zobrazte pouze upozornění.

  • NoItemAndPropertyList.Nezobrazovat seznam položek a vlastnosti, která se objevují na začátku každého sestavení projektu, je-li úroveň podrobností je nastavena na diagnostic.

  • ShowCommandLine.Zobrazit TaskCommandLineEvent zprávy.

  • ShowTimestamp.Zobrazí časové razítko jako předponu ke každé zprávě.

  • ShowEventId.Zobrazí ID události pro každý počáteční událost dokončené události a zprávy.

  • ForceNoAlign.Není zarovnat text, který má 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 jednoprocesorového, zakážete víceprocesorové protokolování styl výstupu.

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

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

Použití středníku nebo čárky k oddělení více parametrů, jako v následujícím příkladu:

/consoleloggerparameters:PerformanceSummary;NoSummary /verbosity:minimal

/distributedFileLogger

/DFL

Do svého vlastního souboru protokolu výstupu sestavení každého uzlu nástroj MSBuild.Výchozí umístění těchto souborů je aktuální adresář.Ve výchozím nastavení, jsou soubory pojmenovány "MSBuildNodeIdlog".Můžete použít /fileLoggerParameters přepínač, chcete-li zadat umístění souborů a dalších parametrů pro fileLogger.

Pokud zadáte název souboru protokolu pomocí /fileLoggerParameters , distribuované s protokoly použité přepínačem, pojmenování jako šablony a přidat uzel ID tohoto názvu při vytváření souboru protokolu pro každý uzel.

/distributedlogger:central logger*forwarding logger

/dl:central logger*forwarding logger

Protokolovat události z nástroje MSBuild připojení instance s různými protokoly do každého uzlu.Chcete-li zadat více úhozy kláves, uvádět odděleně jednotlivých protokolů.

Chcete-li určit protokolovací nástroj použijete syntaxi protokolovacího nástroje.Syntaxe protokolování naleznete /logger přepínač níže.

Následující příklady ukazují způsob použití tohoto parametru:

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

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

/fileLogger[číslo]

/flnumber

Protokolování výstupu sestavení do jednoho souboru v aktuálním adresáři.Nezadáte-li number, výstupní soubor se nazývá msbuild.log.Zadáte-li number, výstupní soubor se nazývá msbuildn.log, kde n je number.Numbermůže být číslice od 1 do 9.

Můžete použít /fileLoggerParameters přepínač zadat umístění souboru a další parametry fileLogger.

/fileloggerparameters: [číslo]parameters

/flp:numberparameters

Určuje soubor protokolování a protokolování souborů DFS žádné dodatečné parametry.Přítomnost tohoto přepínače vyplývá, že odpovídající /filelogger[number] je použit.Numbermůže být číslice od 1 do 9.

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

  • Soubor protokolu.Cesta k souboru protokolu, do kterého je zapsán do protokolu sestavení.Zadání předpony protokolování souborů DFS v souladu tuto cestu k názvům souborů protokolu.

  • Připojit.Určuje, zda protokolu sestavení je přidán do souboru protokolu, nebo jej přepíše.Při nastavení přepínač protokolu sestavení přidán do souboru protokolu.Pokud není nastaven přepínač, budou přepsány obsah existujícího souboru protokolu.

  • 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 varování a chyby:

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

Další možnosti naleznete v následujících příkladech:

/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í nástroj sloužící k protokolování událostí z nástroje MSBuild.Chcete-li zadat více úhozy kláves, uvádět odděleně jednotlivých protokolů.

Použijte následující syntaxi pro logger:[LoggerClass,]LoggerAssembly[;LoggerParameters]

Použijte následující syntaxi pro LoggerClass:[PartialOrFullNamespace.]LoggerClassName

Nemusíte zadat Třída protokolovacího nástroje je-li sestavení obsahuje právě jeden protokolovacího nástroje.

Použijte následující syntaxi pro LoggerAssembly:{AssemblyName[,StrongName] |AssemblyFile}

Parametry protokolování jsou nepovinné a jsou předány do protokolů, přesně tak, jak je zadávat.

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 protokolování konzoly výchozí a Neprotokolovat události do konzoly.

Příklad

V následujícím příkladu je založena rebuild cíl MyProject.proj projektu.

MSBuild.exe MyProject.proj /t:rebuild

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

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

Viz také

Referenční dokumentace

Společné vlastnosti MSBuild projektu

Další zdroje

Nástroj MSBuild odkaz