Názorný postup: Vytvoření projektu Visual C++ pomocí nástroje MSBuild

Článek
03/12/2013

Tento návod ukazuje, jak používat MSBuild k sestavení Visual C++ projektu na příkazovém řádku.Se dozvíte, jak vytvořit zdrojové soubory C++ a souboru založený na jazyce XML projektu pro Visual C++ konzolové aplikace.Po vytvoření projektu, se dozvíte, jak pro přizpůsobení procesu sestavení.

Tento návod ilustruje následující úkoly:

Vytváření zdrojových souborů C++ pro váš projekt.
Vytvoření XML MSBuild souboru projektu.
Pomocí MSBuild k sestavení projektu.
Pomocí MSBuild k úpravě projektu.

Požadavky

Následující k dokončení tohoto názorného postupu potřebujete:

Visual Studio 2010
Obecné principy MSBuild systému.

Vytvoření C++ zdrojové soubory

V tomto návodu vytvoříte projekt, který má zdrojový soubor a soubor hlaviček.Main.cpp zdrojový soubor obsahuje hlavní funkce pro konzolovou aplikaci.Main.h souboru záhlaví obsahuje kód zahrnout soubor iostream záhlaví.Tyto soubory C++ lze vytvořit pomocí Visual Studio nebo textovém editoru.

Chcete-li vytvořit C++ zdrojové soubory projektu

Vytvořte adresář pro váš projekt.

Vytvořte soubor s názvem main.cpp a přidejte následující kód do tohoto souboru:

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

Vytvořte soubor s názvem main.h a přidejte následující kód do tohoto souboru:
```
// main.h: the application header code.
/* Additional source code to include. */
```

Vytvoření souboru XML nástroje MSBuild projektu

MSBuild Soubor projektu je soubor XML, který obsahuje kořenový prvek projektu (<Project>).V následujícím příkladu projektu <Project> Element obsahuje sedm podřízených prvků:

Tři položky skupiny značky (<ItemGroup>), které určují konfiguraci projektu a platformu, název zdrojového souboru a název souboru hlaviček.
Tři import značky (<Import>), které určují umístění Microsoft Visual C++ nastavení.
Vlastnost skupiny značku (<PropertyGroup>), která určuje nastavení projektu.

Chcete-li vytvořit soubor projektu nástroje MSBuild

Pomocí textového editoru vytvořte soubor projektu, který se nazývá myproject.vcxproj, a pak přidejte následující kořenové <Project> element.Vložení prvků v následujících krocích postupu mezi kořenové <Project> tagy:
```
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns=https://schemas.microsoft.com/developer/msbuild/2003>
</Project>
```

Přidat následující dva <ProjectConfiguration> podřízené prvky v <ItemGroup> element.Podřízený prvek určuje ladění a vydání konfigurace pro 32bitové verze operačního systému:

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

Přidejte následující <Import/> prvek, který určuje cestu k výchozí nastavení jazyka C++ pro tento projekt:
```
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.default.props" />
```

Přidejte následující vlastnost skupiny prvku (<PropertyGroup>), který určuje dvě vlastnosti projektu:

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

Přidejte následující <Import/> prvek, který určuje cestu k aktuální nastavení jazyka C++ pro tento projekt:
```
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
```
Přidejte následující <ClCompile> podřízený prvek v <ItemGroup> element.Podřízený prvek určuje název jazyka C/C++ zdrojového souboru pro kompilaci:
```
<ItemGroup>
   <ClCompile Include="main.cpp" />
</ItemGroup>
```
Přidejte následující <ClInclude> podřízený prvek v <ItemGroup> element.Podřízený prvek určuje název souboru hlaviček pro C/C++ zdrojový soubor:
```
<ItemGroup>
   <ClInclude Include="main.h" />
</ItemGroup>
```
Přidejte následující <Import> prvek, který určuje cestu k souboru, který definuje cíl pro tento projekt:
```
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Targets" />
```

Úplný soubor projektu

Následující kód ukazuje soubor celý projekt, který jste vytvořili v předchozí proceduře.

<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>

Pomocí nástroje MSBuild k sestavení projektu

Na příkazovém řádku k vytvoření aplikace konzoly, zadejte následující příkaz:

msbuild myproject.vcxproj /p:configuration=debug

MSBuildVytvoří adresář pro výstupní soubory a kompiluje a propojí projektu k vytvoření programu Myproject.exe.Po dokončení procesu sestavení, použijte následující příkaz ke spuštění aplikace:

myproject

Aplikace by měl zobrazit "text Hello, z nástroje MSBuild!" v okně konzoly.

Přizpůsobení projektu

MSBuildUmožňuje provést sestavení předdefinované cíle, použití uživatelem definované vlastnosti a použít vlastní nástroje, události a kroky sestavení.V této části ilustruje následující úkoly:

Pomocí MSBuild s cíli sestavení.
Pomocí MSBuild s vlastností sestavení.
Pomocí MSBuild s různými modulové.
Přidání MSBuild vlastní nastavení.

Pomocí nástroje MSBuild s cíli sestavení

A vytvořit cíl je pojmenovaná sada předdefinované nebo vlastní příkazy, které mohou být provedeny během sestavení.Použijte parametr příkazového řádku cíl (/t) Chcete-li určit cíl sestavení.V případě, že myproject příklad projektu, předdefinované clean cíl odstraní všechny soubory ve složce ladění a vytvoří nový soubor protokolu.

Na příkazovém řádku zadejte následující příkaz k čištění myproject.

msbuild myproject.vcxproj /t:clean

Pomocí nástroje MSBuild vlastnosti sestavení

Možnost příkazového řádku vlastnosti (/p) umožňuje přepsat vlastnost v souboru sestavení projektu.V myproject příklad projektu, uvolnění nebo ladění sestavení konfigurace je určena Configuration vlastnost.A je určen operační systém, který je určen ke spuštění aplikace vytvořené Platform vlastnost.

Na příkazovém řádku zadejte následující příkaz k vytvoření sestavení ladění myproject aplikace, který je určen pro 32bitové verze systému Windows.

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

Předpokládejme, že myproject příklad projektu také definuje konfiguraci pro 64bitový systém Windows a jiné konfigurace pro vlastní operační systém s názvem myplatform.

Na příkazovém řádku zadejte následující příkaz k vytvoření uvolnění sestavení, která běží na Windows 64-bit.

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

Na příkazovém řádku zadejte následující příkaz k vytvoření sestavení vydání pro myplatform.

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

Pomocí nástroje MSBuild pomocí různých nástrojů

Máte-li oba Visual C++ 9.0 a 10,0 knihovny (modulové) nainstalován, MSBuild mohou vytvářet aplikace pro systém Visual C++ 9.0 nebo 10.0.Chcete-li zadat Visual C++ 9.0 toolset přidejte následující prvek skupiny vlastností do souboru projektu Myproject.vcxproj po Microsoft.Cpp.props <Import/> prvek:

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

Chcete-li znovu sestavit projekt s Visual C++ 9.0 sadu nástrojů, zadejte některý z následujících příkazů:

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

Přidání vlastního nastavení nástroje MSBuild

MSBuildrůzné způsoby přizpůsobení procesu sestavení.Následující témata ukazují, jak přidat vlastní kroky sestavení, nástroje a události, které mají své MSBuild projektu:

Sdílet prostřednictvím