Referenční dokumentace pro použití nástroje MSBuild v příkazovém řádku
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:
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. .gif "Poznámka") Pozná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. |
.gif "ms164311.collapse_all(cs-cz,VS.110).gif")
Př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:
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ů:
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