Program MSBuild

Microsoft Build Engine Jest platformą do budowania aplikacji.Ten aparat, który jest również znany jako MSBuild, zawiera schemat XML dla pliku projektu, który kontroluje sposób platformy kompilacji przetwarza i tworzy oprogramowanie.Program MSBuild korzysta z programu Visual Studio, ale go nie zależy od programu Visual Studio. Wywołując msbuild.exe na Twój projekt lub plik rozwiązania można organizacji i budowanie produkty w środowisku, w którym nie jest zainstalowany program Visual Studio.

Visual Studio traktuje MSBuild do ładowania i budowania projektów zarządzanych.Pliki projektu w programie Visual Studio (.csproj, .vbproj, vcxproj i inne) zawiera kod programu MSBuild XML, który jest wykonywany podczas tworzenia projektu przy użyciu IDE.Projektów programu Visual Studio zaimportować wszystkie wymagane ustawienia i tworzenia procesów do prac rozwojowych typowe, ale można rozszerzyć lub zmodyfikować je od środowiska Visual Studio lub za pomocą edytora XML.

Poniższe przykłady ilustrują, jeśli buduje może być uruchamiane za pomocą wiersza polecenia programu MSBuild zamiast programu Visual Studio IDE.

• Nie jest zainstalowany program Visual Studio.

• Chcesz użyć w 64-bitowej wersji programu MSBuild.Ta wersja programu MSBuild jest zazwyczaj zbędne, ale pozwala MSBuild uzyskać dostęp do więcej pamięci.

• Chcesz uruchomić kompilacji w wielu procesach.Jednak można użyć IDE, aby uzyskać ten sam efekt na projekty w języku C++ i, począwszy od programu Visual Studio 2012 C#.

• Należy zmodyfikować system kompilacji.Na przykład można wykonywać następujące akcje:

  • Wstępnie przetwórz pliki, zanim dotrą do kompilatora.

  • Skopiuj wyjść kompilacji w inne miejsce.

  • Tworzenie skompresowanych plików z wyjścia kompilacji.

  • Wykonaj krok post-processingu.Na przykład możesz chcieć znaczek zestawu z innej wersji.

Można wpisać kod w programie Visual Studio IDE, ale Uruchom tworzy się przy użyciu programu MSBuild.Jako alternatywnego sposobu można zbudować kod w IDE na komputerze deweloperskim, ale kompilowania kodu, który jest zintegrowany z wielu deweloperów za pomocą wiersza polecenia programu MSBuild.

[!UWAGA]

Umożliwia Team Foundation Build automatycznie kompilować, testowania i wdrażania aplikacji.Twój kompilacji systemu może automatycznie uruchomić buduje, gdy deweloperzy zaewidencjonować kod (na przykład, jako część strategii ciągłej integracji) lub według harmonogramu (na przykład nocny budować zbudować testu weryfikacji).Team Foundation Build kompiluje kod przy użyciu programu MSBuild.Aby uzyskać więcej informacji, zobacz Tworzenie aplikacji.

Ten temat zawiera omówienie programu MSBuild.Samouczek wprowadzający, zobacz Instruktaż: Przy użyciu programu MSBuild.

W tym temacie

• W wierszu polecenia przy użyciu programu MSBuild

• Plik projektu

  • Właściwości

  • Elementy

  • Zadania

  • Obiekty docelowe

• Tworzenie dzienników

• Za pomocą programu MSBuild w programie Visual Studio

• Aktualnie

W wierszu polecenia przy użyciu programu MSBuild

Aby uruchomić MSBuild w wierszu polecenia, należy przekazać plik projektu do MSBuild.exe, wraz z odpowiednimi opcjami wiersza polecenia.Opcje wiersza polecenia umożliwiają ustawianie właściwości, wykonać szczegółowe cele i ustawić inne opcje, które kontrolują proces budowania.Będzie na przykład użyć następującej składni wiersza polecenia, aby utworzyć plik MyProj.proj z Configuration wartość właściwości równa Debug.

MSBuild.exe MyProj.proj /property:Configuration=Debug

Aby uzyskać więcej informacji o MSBuild opcji wiersza polecenia, zobacz Informacje w wierszu polecenia programu MSBuild. 

Uwaga dotycząca zabezpieczeń
Przed pobraniem projektu określenie wiarygodności kod.

Plik projektu

MSBuildużywa formatu plików projektów opartych na języku XML, który jest bardzo proste i extensible.MSBuild Format pliku programu project umożliwia deweloperom opisano elementy, które mają być budowane, a także, jak są one mają zostać zbudowane dla różnych systemów operacyjnych i konfiguracji.Ponadto w formacie pliku programu project umożliwia zasady tworzenia wielokrotnego użytku Autor deweloperów, które mogą być rozkładane do oddzielnych plików, tak aby wersje mogą być wykonywane konsekwentnie między różnymi projektami w produkcie.

W poniższych sekcjach opisano niektóre z podstawowych elementów MSBuild format pliku programu project. Samouczek o tworzeniu pliku projektu podstawowych, zobacz Instruktaż: Tworzenie pliku projektu programu MSBuild od początku.

Właściwości

Właściwości reprezentują par klucz wartość, których można używać do konfigurowania buduje.Właściwości są zgłaszane przez tworzenie elementu, który ma nazwę właściwości jako element podrzędny PropertyGroup element.Na przykład, poniższy kod tworzy właściwość o nazwie BuildDir , który ma wartość Build.

<PropertyGroup>
    <BuildDir>Build</BuildDir>
</PropertyGroup>

Można zdefiniować właściwość warunkowo przez umieszczenie Condition atrybutu w elemencie.Zawartość elementów warunkowego są ignorowane, chyba, że warunek jest true.W poniższym przykładzie Configuration element jest definiowany, jeśli jeszcze nie został zdefiniowany.

<Configuration  Condition=" '$(Configuration)' == '' ">Debug</Configuration>

Właściwości można się odwoływać w całym pliku projektu przy użyciu składni $(PropertyName).Na przykład właściwości w poprzednich przykładach można się odwoływać za pomocą $(BuildDir) i $(Configuration).

Aby uzyskać więcej informacji o właściwościach, zobacz Program MSBuild właściwości.

Elementy

Elementy są wejścia do systemu kompilacji i zazwyczaj reprezentują pliki.Elementy są grupowane w typami towarów, na podstawie nazw elementu zdefiniowanego przez użytkownika.Tymi typami towarów mogą być używane jako parametry dla zadania, które umożliwia wykonywanie czynności procesu tworzenia poszczególnych elementów.

Elementy są deklarowane w pliku projektu przez utworzenie elementu, który ma nazwę typu element jako element podrzędny ItemGroup element.Na przykład, poniższy kod tworzy typ elementu o nazwie Compile, który zawiera dwa pliki.

<ItemGroup>
    <Compile Include = "file1.cs"/>
    <Compile Include = "file2.cs"/>
</ItemGroup>

Typy elementów można się odwoływać w całym pliku projektu przy użyciu składni @(ItemType).Na przykład typ elementu w przykładzie będzie się odwoływać za pomocą @(Compile).

W program MSBuild element i atrybut nazwy jest wielkość liter.Jednak nazwy właściwości, przedmiot i metadane nie są.Poniższy przykład tworzy typ elementu Compile, comPile, lub inne sprawy zmiany i daje wartość "one.cs;two.cs" typu elementu.

<ItemGroup>
  <Compile Include="one.cs" />
  <comPile Include="two.cs" />
</ItemGroup>

Elementy uznaje się za pomocą znaków wieloznacznych i mogą zawierać dodatkowe metadane dla bardziej zaawansowanych scenariuszy budowlanych.Aby uzyskać więcej informacji o elementach, zobacz Program MSBuild elementów.

Zadania

Zadania są jednostkami pliku wykonywalnego kodu, który MSBuild projekty umożliwia wykonywanie operacji budowania.Na przykład zadanie może skompilować plików wejściowych lub uruchomić zewnętrznych.Zadania mogą być wielokrotnie używane, i mogą być współużytkowane przez różnych deweloperów w różnych projektach.

Logiki wykonywanie zadania jest pisany kod zarządzany i mapowane na MSBuild za pomocą UsingTask element.Można pisać własne zadania przy authoring typu zarządzanego, który implementuje ITask interfejsu.Aby uzyskać więcej informacji na temat pisania zadań, zobacz Zapisywanie zadania.

MSBuildzawiera typowe zadania, które można modyfikować zgodnie z własnymi preferencjami.Przykładami są kopię, który kopiuje pliki, MakeDir, który tworzy katalogi, i Csc, który kompiluje pliki kodu źródłowego języka Visual C#.Aby uzyskać listę dostępnych zadań wraz z informacje o sposobie użycia, zobacz Zadanie programu MSBuild odniesienia.

Zadanie jest wykonywane w MSBuild pliku projektu, przez utworzenie elementu, który ma nazwę zadania jako element podrzędny docelowej element.Zadania zazwyczaj akceptuje parametry, które mają być wykonane jako atrybuty elementu.Obie MSBuild właściwości i elementy mogą być używane jako parametry.Na przykład, poniższy kod wywoła MakeDir zadań i przekazuje go wartość BuildDir właściwość, która została uznana w poprzedniego przykładu.

<Target Name="MakeBuildDirectory">
    <MakeDir  Directories="$(BuildDir)" />
</Target>

Aby uzyskać więcej informacji na temat zadań, zobacz Program MSBuild zadań.

Obiekty docelowe

Zgrupować zadania w określonym porządku oraz udostępnić sekcje pliku projektu, jako punkty wejścia do procesu tworzenia.Cele często są podzielone na logiczne sekcje, aby zwiększyć czytelność i aby zezwolić na rozszerzenie.Kroki kompilacji włamanie się do obiektów docelowych pozwala połączyć jeden kawałek interpretowanych z pozostałych elementów docelowych bez kopiowania tej sekcji kodu do każdego obiektu docelowego.Na przykład jeśli kilka punktów wejścia do procesu tworzenia wymagają odwołania do zabudowy, można utworzyć obiektu docelowego, który tworzy odwołania, a następnie uruchomić działania z programem z każdego punktu wejścia, gdzie jest to wymagane.

Obiekty docelowe są zadeklarowane w pliku projektu za pomocą docelowej element.Na przykład, poniższy kod tworzy element docelowy o nazwie Compile, które następnie telefonuje Csc zadania, które ma na liście element, zgłoszonego we wcześniej np.

<Target Name="Compile">
    <Csc Sources="@(Compile)" />
</Target>

W bardziej zaawansowanych scenariuszy cele może służyć do opisywania relacji między sobą i przeprowadzanie analizy zależność, tak aby całe sekcje interpretowanych można pominąć, jeśli do działania z programem jest aktualny.Aby uzyskać więcej informacji dotyczących obiektów docelowych, zobacz Cele programu MSBuild.

Tworzenie dzienników

Można rejestrować błędy kompilacji, ostrzeżenia i komunikaty konsoli lub innym urządzeniu wyjściowym.Aby uzyskać więcej informacji, zobacz Uzyskiwanie dzienników kompilacji za pomocą narzędzia MSBuild i Rejestrowanie w MSBuild.

Za pomocą programu MSBuild w programie Visual Studio

Visual Studioużywa MSBuild format pliku programu project do przechowywania informacji o kompilacji o zarządzanych projektów.Ustawienia, które są dodane lub zmienione za pomocą projektu Visual Studio interfejsu są odzwierciedlane w. * proj pliku, który jest generowany dla każdego projektu.Visual Studioużywa obsługiwane wystąpienie z MSBuild do budowania projektów zarządzanych.Oznacza to, że zarządzany projektu mogą być wbudowane Visual Studio lub w wierszu polecenia (nawet wtedy, gdy Visual Studio nie jest zainstalowana), a ich wyniki są identyczne.

Samouczek o sposobach używania programu MSBuild w programie Visual Studio, zobacz Instruktaż: Przy użyciu programu MSBuild.

Aktualnie

Za pomocą programu Visual Studio, będzie można kompilować aplikacji do uruchamiania na dowolną spośród kilku różnych wersjach systemu.NET Framework.Na przykład można kompilować aplikacji do uruchamiania na.NET Framework 2.0 na platformie 32-bitowe i będzie można kompilować tej samej aplikacji do uruchamiania na 4.5.NET Framework na platformie 64-bitowych.Zdolność do kompilowania do więcej niż jednej struktury nosi nazwę aktualnie.

Oto niektóre korzyści wynikające z aktualnie:

• Użytkownik może tworzyć aplikacje przeznaczone dla wcześniejszych wersji.NET Framework, na przykład wersje 2.0, 3.0 i 3.5.

• Można kierować RAM innych niż.NET Framework, na przykład dodatku Silverlight.

• Można kierować framework profile, który jest uprzednio zdefiniowanego podzbioru ramy docelowej.

• Jeśli dodatek service pack dla bieżącej wersji programu.NET Framework jest zwalniane, można wskazać ją.

• Aktualnie gwarantuje, że aplikacja używa tylko funkcji dostępnych w ramach docelowej i platformy.

Aby uzyskać więcej informacji, zobacz Omówienie aktualnie MSBuild.

Tematy pokrewne

Tytuł	Opis
Instruktaż: Tworzenie pliku projektu programu MSBuild od początku	Przedstawiono sposób tworzenia pliku projektu podstawowych przyrostowo, przy użyciu tylko tekst edytora.
Instruktaż: Przy użyciu programu MSBuild	Wprowadzono bloki konstrukcyjne programu MSBuild i pokazuje, jak napisać, manipulować i program Debug: polecenie MSBuild projektów bez zamykania programu Visual Studio IDE.
Pojęcia dotyczące programu MSBuild	Przedstawia cztery budulcem MSBuild: właściwości, elementy, cele i zadania.
Program MSBuild elementów	W tym artykule opisano ogólne pojęcia dotyczące MSBuild format pliku jak elementy pasują do siebie.
Program MSBuild właściwości	Wprowadza, właściwości i kolekcje właściwości.Właściwości są buduje par klucz wartość, których można używać do konfigurowania.
Cele programu MSBuild	Omówiono sposoby grupowania zadań ze sobą w określonej kolejności i włączyć sekcje procesu tworzenia się nazywać w wierszu polecenia.
Program MSBuild zadań	Pokazuje, jak utworzyć jednostkę kodu wykonywalnego, które mogą być używane przez MSBuild do wykonywania operacji budowania Atomowej.
Program MSBuild warunki	Omówienie sposobów wykorzystania Condition atrybutu w elemencie programu MSBuild.
Program MSBuild zaawansowane pojęcia	Przedstawia dozowania, wykonywanie przekształceń, aktualnie i innych zaawansowanych technik.
Rejestrowanie w MSBuild	W tym artykule opisano, jak rejestrować zdarzenia kompilacji, wiadomości i błędy.
Dodatkowe zasoby MSBuild	Wyświetla listę zasobów Wspólnota i pomoc techniczna, aby uzyskać więcej informacji na temat programu MSBuild.

Informacje o odwołaniach

• Program MSBuild odniesienia
  Łącza do tematów, które zawierają informacje o odwołanie.

• Program MSBuild słowniczek
  Definiuje typowe terminy programu MSBuild.