Instruktaż: Przy użyciu programu MSBuild do tworzenia projektu Visual C++

Artykuł
03/12/2013

W tym instruktażu przedstawiono sposób użycia MSBuild do budowy Visual C++ projektu w wierszu polecenia.Omówiono sposób tworzenia plików źródłowych języka C++ i pliku projektu opartych na języku XML dla Visual C++ konsoli aplikacji.Po zbudowaniu projektu, zostaną informacje o sposobach dostosowywania procesu tworzenia.

W przewodniku przedstawiono następujące zagadnienia:

Tworzenie plików źródłowych języka C++ dla projektu.
Tworzenie kodu XML MSBuild pliku projektu.
Za pomocą MSBuild do zrealizowania pewnego projektu.
Za pomocą MSBuild do dostosowywania projektu.

Wymagania wstępne

Następujące czynności w tym instruktażu są potrzebne:

Visual Studio 2010
Ogólnej wiedzy na temat MSBuild systemu.

Tworzenie plików źródłowych języka C++

W tym instruktażu użytkownik utworzy projekt, który ma plik źródłowy i plik nagłówkowy.Main.cpp plik źródłowy zawiera główną funkcją dla aplikacji konsoli.Main.h pliku nagłówka zawiera kod, aby dołączyć plik nagłówkowy iostream.Te pliki C++ można utworzyć za pomocą Visual Studio lub edytora tekstu.

Aby utworzyć pliki źródłowe C ++ dla projektu

Utwórz katalog dla projektu.

Utwórz plik o nazwie main.cpp i Dodaj następujący kod do tego pliku:

// main.cpp : the application source code.
#include <iostream>
#include "main.h"
int main()
{
   std::cout << "Hello, from MSBuild!\n";
   return 0;
}

Utwórz plik o nazwie main.h i Dodaj następujący kod do tego pliku:

// main.h: the application header code.
/* Additional source code to include. */

Tworzenie pliku projektu programu MSBuild XML

MSBuild Plik projektu jest plikiem XML, który zawiera element główny projektu (<Project>).Następujący przykład projektu, <Project> element zawiera siedem elementów podrzędnych:

Trzy element grupy znaczniki (<ItemGroup>) określające konfiguracji projektu i platformy, nazwa pliku źródłowego i nazwa pliku nagłówka.
Trzy importowanie znaczników (<Import>), które określają lokalizację Microsoft Visual C++ ustawienia.
Właściwości grupy znacznik (<PropertyGroup>), który określa ustawienia projektu.

Aby utworzyć plik projektu programu MSBuild

Za pomocą edytora tekstu Utwórz plik projektu, który ma nazwę myproject.vcxproj, a następnie dodaj następujący katalog główny <Project> element.Wstaw elementy w poniższych krokach procedury między główny <Project> znaczniki:
```
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns=https://schemas.microsoft.com/developer/msbuild/2003>
</Project>
```

Dodawanie następujących dwóch <ProjectConfiguration> elementy podrzędne w <ItemGroup> element.Element podrzędny określa debugowania i zwolnij konfiguracje dla 32-bitowego systemu operacyjnego Windows:

<ItemGroup>
   <ProjectConfiguration Include="Debug|Win32">
      <Configuration>Debug</Configuration>
      <Platform>Win32</Platform>
   </ProjectConfiguration>
   <ProjectConfiguration Include="Release|Win32">
      <Configuration>Release</Configuration>
      <Platform>Win32</Platform>
   </ProjectConfiguration>
</ItemGroup>

Dodaj następujący <Import/> element, który określa ścieżkę C++ domyślne ustawienia dla tego projektu:
```
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.default.props" />
```

Dodaj następujące właściwości elementu grupy (<PropertyGroup>) określający dwie właściwości projektu:

<PropertyGroup>
   <ConfigurationType>Application</ConfigurationType>
   <ShowAllFiles>false</ShowAllFiles>
</PropertyGroup>

Dodaj następujący <Import/> element, który określa ścieżkę bieżących ustawień języka C++ dla tego projektu:
```
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
```
Dodaj następujący <ClCompile> element podrzędny w <ItemGroup> element.Element podrzędny określa nazwę pliku źródłowego C/C++ do kompilowania:
```
<ItemGroup>
   <ClCompile Include="main.cpp" />
</ItemGroup>
```
Dodaj następujący <ClInclude> element podrzędny w <ItemGroup> element.Element podrzędny określa nazwę pliku nagłówka dla pliku źródłowego C/C++:
```
<ItemGroup>
   <ClInclude Include="main.h" />
</ItemGroup>
```
Dodaj następujący <Import> element, który określa ścieżkę pliku, który definiuje obiekt docelowy dla tego projektu:
```
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Targets" />
```

Pełny plik projektu

W poniższym kodzie pokazano pliku pełną projektu, który został utworzony w poprzedniej procedurze.

<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
  <ItemGroup>
    <ProjectConfiguration Include="Debug|Win32">
      <Configuration>Debug</Configuration>
      <Platform>Win32</Platform>
    </ProjectConfiguration>
    <ProjectConfiguration Include="Release|Win32">
      <Configuration>Release</Configuration>
      <Platform>Win32</Platform>
    </ProjectConfiguration>
  </ItemGroup>
  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.default.props" />
  <PropertyGroup>
    <ConfigurationType>Application</ConfigurationType>
    <ShowAllFiles>false</ShowAllFiles>
  </PropertyGroup>
  <Import Project="$(VCTargetsPath)/Microsoft.Cpp.props" />
  <ItemGroup>
    <ClCompile Include="main.cpp" />
  </ItemGroup>
  <ItemGroup>
    <ClInclude Include="main.h" />
  </ItemGroup>
  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Targets" />
</Project>

Za pomocą programu MSBuild do zrealizowania pewnego projektu

Wpisz następujące polecenie w wierszu polecenia, aby tworzyć aplikację konsoli:

msbuild myproject.vcxproj /p:configuration=debug

MSBuildTworzy katalog dla plików wyjściowych, a następnie kompiluje i łączy projektu w celu generowania programu Myproject.exe.Po zakończeniu procesu tworzenia, należy użyć następującego polecenia do uruchomienia aplikacji:

myproject

Aplikacji "Hello, z MSBuild!" powinien być wyświetlany w oknie konsoli.

Dostosowywanie projektu

MSBuildUmożliwia wykonanie kompilacji wstępnie zdefiniowanych obiektów docelowych, zastosować właściwości zdefiniowane przez użytkownika i użyć narzędzia niestandardowe, zdarzenia oraz kroki kompilacji.W tej sekcji przedstawiono następujące zadania:

Za pomocą MSBuild z obiektami docelowymi kompilacji.
Za pomocą MSBuild z właściwościami kompilacji.
Za pomocą MSBuild z różnych zestawów narzędzi.
Dodawanie MSBuild dostosowań.

Za pomocą programu MSBuild z obiektami docelowymi kompilacji

A budowanie docelowej jest nazwany zestaw poleceń wstępnie zdefiniowane lub zdefiniowane przez użytkownika, które mogą być wykonywane podczas budowy.Użyj opcji wiersza polecenia docelowej (/t) aby określić cel kompilacji.W odniesieniu do myproject przykładowy projekt, wstępnie clean docelowej usuwa wszystkie pliki w folderze Program debug i tworzy nowy plik dziennika.

W wierszu polecenia wpisz następujące polecenie, aby oczyścić myproject.

msbuild myproject.vcxproj /t:clean

Za pomocą programu MSBuild z właściwości Build

Właściwość opcji wiersza polecenia (/p) pozwala na przesłonięcie właściwości w pliku kompilacji projektu.W myproject przykładowej konfiguracji kompilacji projektu, wydanie lub debugowania jest określony przez Configuration właściwość.I system operacyjny, który jest przeznaczony do uruchamiania aplikacji zbudowany jest określony przez Platform właściwość.

W wierszu polecenia wpisz następujące polecenie, aby utworzyć kompilacja do debugowania myproject aplikacji, która jest przeznaczona do działania z 32-bitowej wersji systemu Windows.

msbuild myproject.vcxproj /p:configuration=debug /p:platform=win32

Założenie, że myproject przykład projektu również definiuje konfigurację dla 64-bitowego systemu Windows, a innej konfiguracji dla niestandardowych systemu operacyjnego o nazwie myplatform.

W wierszu polecenia wpisz następujące polecenie, aby utworzyć publikację budowy, które działa w 64-bitowej wersji Windows.

msbuild myproject.vcxproj /p:configuration=release /p:platform=x64

W wierszu polecenia wpisz następujące polecenie, aby utworzyć wydanej kompilacji dla myplatform.

msbuild myproject.vcxproj /p:configuration=release /p:platform=myplatform

Za pomocą programu MSBuild z innego zestawu narzędzi

Jeśli obie Visual C++ 9.0 i 10,0 biblioteki (procesami) zainstalowane, MSBuild można tworzyć aplikacje dla albo Visual C++ 9.0 lub 10.0.Aby określić Visual C++ 9.0 zestaw narzędzi, Dodaj następujący element grupy właściwości do pliku projektu Myproject.vcxproj po Microsoft.Cpp.props <Import/> element:

<PropertyGroup>
    <PlatformToolset>v90</PlatformToolset>
</PropertyGroup>

Aby ponownie skompiluj projekt z Visual C++ 9.0 zestaw narzędzi, należy wpisać jedno z następujących poleceń:

msbuild myproject.vcxproj /p:PlatformToolset=v90 /t:rebuild 
msbuild myproject.vcxproj /t:rebuild

Dodawanie dostosowań programu MSBuild

MSBuildoferuje różne metody, aby dostosować proces kompilacji.W następujących tematach opisano sposób dodawania kroki kompilacji niestandardowej, narzędzia i zdarzenia do swojej MSBuild projektu:

Udostępnij za pośrednictwem