Informacje w wierszu polecenia programu MSBuild
Korzystając z programu MSBuild.exe Aby utworzyć plik projektu lub rozwiązanie, można dołączyć kilka przełączników, aby określić różne aspekty procesu.
MSBuild.exe [Switches] [ProjectFile]
Argumenty
Argument |
Opis |
|---|---|
ProjectFile |
Tworzy obiekty docelowe w pliku projektu, który określisz.Jeśli nie określisz pliku projektu, program MSBuild przeszukuje bieżący katalog roboczy dla rozszerzenia nazwy pliku, który kończy się za "proj" i używa tego pliku.Można również określić plik rozwiązania Visual Studio dla tego argumentu. |
Przełączniki
Przełącznik |
Forma krótka |
Opis |
|---|---|---|
/ Help |
/?lub /h |
Wyświetlić informacje o sposobie użycia.Następujące polecenie znajduje się przykład: msbuild.exe /? |
/detailedsummary |
/ ds |
Umożliwia wyświetlenie szczegółowych informacji na koniec dziennika kompilacji o konfiguracji, które zostały zbudowane i jak zostały zaplanowane do węzłów. |
/ignoreprojectextensions:extensions |
/ ignore:extensions |
Ignoruj określonymi rozszerzeniami, przy ustalaniu których pliku projektu w celu utworzenia.Użyj średnikiem lub przecinkiem, aby oddzielić wiele rozszerzeń, co ilustruje poniższy przykład: /ignoreprojectextensions:.vcproj,.sln |
/maxcpucount [:number |
/m[:number |
Określa maksymalną liczbę równoczesnych procesów będzie używana podczas budowania.Jeśli ten przełącznik nie zostanie uwzględniony, wartością domyślną jest 1.Jeśli ten przełącznik zostanie uwzględniony bez określenia wartości, program MSBuild użyje do liczby procesorów w komputerze.Aby uzyskać więcej informacji, zobacz Równoległe tworzenie wielu projektów za pomocą narzędzia MSBuild. Poniższy przykład powoduje, że program MSBuild zbudować przy użyciu trzech MSBuild procesów, co pozwala trzech projektów zbudować w tym samym czasie: msbuild myproject.proj /maxcpucount:3 |
/ noautoresponse |
/noautorsp |
Nie uwzględnia żadnych plików MSBuild.rsp automatycznie. |
/nodeReuse:value |
/nr:value |
Włącz lub Wyłącz ponowne wykorzystywanie węzły MSBuild.Można określić następujące wartości:
Węzeł odnosi się do projektu, który jest wykonywany.Jeśli dołączysz /maxcpucount przełącznika, wiele węzłów mogą być wykonywane jednocześnie. |
/ nologo |
Nie wyświetlaj transparentu startowego lub komunikatu o prawach autorskich. |
|
/ przetwarzania wstępnego [:filepath |
/pp[:filepath |
Utwórz plik projektu pojedynczy, zagregowane przez inline wszystkie zaznaczone pliki, które przywożono podczas kompilacji, z ich granice.Można użyć tego przełącznika, aby łatwiej określić, które pliki są importowane, z którym pliki są importowane pliki, które pliki przyczyniają się do kompilacji.Gdy ta opcja zostanie użyta, projektu nie jest tworzona. Jeśli określisz filepath, plik projektu zagregowane są kierowane do pliku.W przeciwnym razie dane wyjściowe są wyświetlane w oknie konsoli. Aby uzyskać informacje o sposobach używania Import element, aby wstawić plik projektu do innego pliku programu project, zobacz Elementu importu (MSBuild) i Jak: Użyj tej samej lokalizacji docelowej w wielu plikach programu Project. |
/Property:name=value |
/p:name=value |
Ustawianie lub zastąpić określone właściwości poziomu projektu, gdzie name jest nazwą właściwości i value jest wartość właściwości.Każda właściwość oddzielnie lub użyj średniki lub przecinki do oddzielenia poszczególnych właściwości, jak pokazano w następującym przykładzie: /property:WarningLevel=2;OutputDir=bin\Debug |
/ Target:targets |
/ t:targets |
Budowanie sprecyzowanych celów w projekcie.Każdy cel oddzielnie lub użyj średniki lub przecinki do oddzielenia wielu celów, jak pokazano w następującym przykładzie: /target:Resources;Compile Jeśli określisz wszelkie cele za pomocą tego przełącznika, są one uruchamiane zamiast wszelkie cele w DefaultTargets atrybut w pliku projektu.Aby uzyskać więcej informacji, zobacz Zamówienie docelowej i Jak: Określ, które docelowych do kompilacji najpierw. Element docelowy jest grupy zadań.Aby uzyskać więcej informacji, zobacz Cele programu MSBuild. |
/toolsversion:version |
/TV:version |
Określa wersję zestaw narzędzi, aby skonstruować projektu, co ilustruje poniższy przykład:/toolsversion:3.5 Za pomocą tego przełącznika, można zbudować projekt i określić wersję, która różni się od wersji, która jest określona w Element projektu (MSBuild).Aby uzyskać więcej informacji, zobacz Zastępowanie ustawień ToolsVersion. Dla programu MSBuild 4.5, można określić następujące wartości dla version: 2.0, 3.5 i 4.0.Jeśli określisz 4.0, VisualStudioVersion właściwość kompilacji Określa, które toolset sub, aby użyć.Aby uzyskać więcej informacji, zobacz sekcję zestawów narzędzi Sub Zestaw narzędzi MSBuild (ToolsVersion). Opis narzędzia składa się z zadania, cele i narzędzia, które są używane do budowania aplikacji.Obejmują one kompilatory takie jak csc.exe i vbc.exe.Aby uzyskać więcej informacji na temat zestawów narzędzi, zobacz Zestaw narzędzi MSBuild (ToolsVersion), Konfiguracje standardowego i niestandardowego zestawu narzędzi, i Omówienie aktualnie MSBuild. .gif "Uwaga") Uwaga
Wersja zestawu narzędzi nie jest taki sam jak systemu docelowego, który jest wersją.NET Framework, na którym projekt jest skompilowany w celu uruchamiania.Aby uzyskać więcej informacji, zobacz Ramy docelowych MSBuild i platforma docelowa.
|
/ validate: schema |
/valschema |
Sprawdź poprawność pliku projektu i, jeśli weryfikacja przebiegnie pomyślnie, skompiluj projekt. Jeśli nie zostanie określony schema, projekt jest sprawdzany domyślnego schematu. Jeśli określisz schema, projekt jest sprawdzana względem schematu, który określisz. Następujące ustawienie jest przykładem:/validate:MyExtendedBuildSchema.xsd |
/Verbosity:level |
/ v:level |
Określa ilość informacji do wyświetlenia w dzienniku kompilacji.Każdy rejestrator wyowietlane są zdarzenia, w zależności od poziomu szczegółowości, ustawionego dla tego rejestratora. Można określić następujące poziomy szczegółowości: q[uiet], m[inimal], n[ormal], d[etailed], i diag[nostic]. Następujące ustawienie jest przykładem:/verbosity:quiet |
/version |
/ VER |
Wyświetlić tylko informacje o wersji.Projekt nie jest wbudowana. |
@file |
Przełączniki wiersza polecenia Wstaw z pliku tekstowego.Jeśli masz wiele plików, możesz określić je oddzielnie.Aby uzyskać więcej informacji, zobacz Program MSBuild plików odpowiedzi. |
.gif "ms164311.collapse_all(pl-pl,VS.110).gif")
Przełączniki programu Rejestrator
Przełącznik |
Forma krótka |
Opis |
|---|---|---|
/consoleloggerparameters:parameters |
/CLP:parameters |
Przekazywanie parametrów, określonych przez użytkownika do programu rejestrującego konsoli, który wyświetla informacja o kompilacji w oknie konsoli.Można określić następujące parametry:
Użyj średniki lub przecinki do oddzielenia wielu parametrów, jak pokazano w następującym przykładzie: /consoleloggerparameters:PerformanceSummary;NoSummary /verbosity:minimal |
/distributedFileLogger |
/DFL |
Zaloguj się budować produkcja każdego węzła MSBuild własny plik.Położenie początkowe dla tych plików jest katalog bieżący.Domyślnie pliki są nazywane "MSBuildNodeIddziennika (.log)".Można użyć /fileLoggerParameters przełącznika, aby określić lokalizację plików oraz innych parametrów dla fileLogger. Jeśli nazwa pliku dziennika za pomocą /fileLoggerParameters przełącznika, rozproszonych rejestratora użyje który nazwany jako szablon i dołączyć identyfikator węzła do tej nazwy podczas tworzenia pliku dziennika dla każdego węzła. |
/distributedlogger:central logger*forwarding logger |
/dl:central logger*forwarding logger |
Dziennik zdarzeń z MSBuild dołączanie wystąpienia różnych rejestratora do każdego węzła.Aby określić wiele rejestratory, określić oddzielnie każdy rejestrator. Określ Rejestrator za pomocą składni rejestratora.Rejestrator składnię, zobacz /logger przełącznik poniżej. Następujące przykłady przedstawiają metody korzystania z tego przełącznika: /dl:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral /dl:MyLogger,C:\My.dll*ForwardingLogger,C:\Logger.dll |
/fileLogger[numer] |
/flnumber |
Dziennika produkcji kompilacji w pojedynczym pliku w katalogu bieżącym.Jeśli nie zostanie określony number, plik wyjściowy o nazwie msbuild.log.Jeśli określisz number, plik wyjściowy o nazwie msbuildn.log, gdzie n jest number.Numbermoże być cyfrę od 1 do 9. Można użyć /fileLoggerParameters przełącznika, aby określić lokalizację pliku i inne parametry dla fileLogger. |
/fileloggerparameters: [numer]parameters |
/flp:numberparameters |
Określa wszelkie dodatkowe parametry dla rejestratora pliku i Rejestrator DFS.Obecności tej opcji oznacza, że odpowiadające im /filelogger[number] znajduje się przełącznik.Numbermoże być cyfrę od 1 do 9. Można użyć wszystkich parametrów, które są wymienione w /consoleloggerparameters.Umożliwia także, przynajmniej jedną z następujących parametrów:
W poniższym przykładzie generuje oddzielne pliki dziennika dla ostrzeżeń i błędów: /flp1:logfile=errors.txt;errorsonly /flp2:logfile=warnings.txt;warningsonly Następujące przykłady przedstawiają inne możliwości: /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: wyświetlenielogger |
Określa rejestratora służy do rejestrowania zdarzeń z programu MSBuild.Aby określić wiele rejestratory, określić oddzielnie każdy rejestrator. Należy użyć następującej składni dla logger:[LoggerClass,]LoggerAssembly[;LoggerParameters] Należy użyć następującej składni dla LoggerClass:[PartialOrFullNamespace.]LoggerClassName Nie trzeba określić klasy rejestratora, jeżeli zgromadzenie zawiera dokładnie jeden rejestrator. Należy użyć następującej składni dla LoggerAssembly:{AssemblyName[,StrongName] |AssemblyFile} Rejestrator parametry są opcjonalne i są przekazywane do programu rejestrującego, dokładnie tak, jak je wprowadzić. W następujących przykładach użyto /logger przełączyć. /logger:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral /logger:XMLLogger,C:\Loggers\MyLogger.dll;OutputAsHTML |
/noconsolelogger |
/noconlog |
Wyłączyć rejestrator domyślny konsoli, a nie Rejestruj zdarzenia do konsoli. |
Przykład
Poniższy przykład tworzy rebuild cel MyProject.proj projektu.
MSBuild.exe MyProject.proj /t:rebuild
MSBuild.exe można użyć, aby wykonać opiera się bardziej złożone.Na przykład służy on do tworzenia szczegółowych celów szczególnych projektów w ramach rozwiązania.Poniższy przykład buduje ponownie projektu NotInSolutionFolder i czyści projektu InSolutionFolder, który jest w NewFolder folder rozwiązania.
msbuild SlnFolders.sln /t:NotInSolutionfolder:Rebuild;NewFolder\InSolutionFolder:Clean
Zobacz też
Informacje
Wspólne właściwości projektu MSBuild