Standardní a vlastní konfigurace sady nástrojů

Článek
03/04/2013

Sada nástrojů nástroj MSBuild obsahuje úkoly, cíle a nástroje, které můžete vytvořit projekt aplikace.MSBuild obsahuje standardní sadu nástrojů, ale můžete také vytvořit vlastní modulové.Informace o zadání sada nástrojů naleznete v tématuSada nástrojů MSBuild (atribut ToolsVersion)

Standardní sada nástrojů konfigurace

MSBuild4.5 obsahuje následující standardní modulové:

ToolsVersion	Cesta Toolset (jako vlastnosti sestavení MSBuildToolsPath nebo MSBuildBinPath)
2.0	Cesta instalace systému Windows\Microsoft.Net\Framework\v2.0.50727\
3.5	Cesta instalace systému Windows\Microsoft.NET\Framework\v3.5.20223\
4.0	Cesta instalace systému Windows\Microsoft.NET\Framework\v4.0.30319\

ToolsVersion Hodnota určuje, které používají sadu nástrojů projektu, který generuje sada Visual Studio.Zadáte ToolsVersion jako atribut v projektu element souboru projektu, ale přepsat pomocí atributu /toolsversion přepínač příkazového řádku.Informace o tento atribut, tento přepínač a jiné způsoby zadání ToolsVersion, viz Přepsání nastavení ToolsVersion.

Pokud ToolsVersion není zadán, definovat následující klíče ToolsVersion.

Podregistr registru	Název klíče	Hodnota řetězce klíčů
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\3.5\	DefaultToolsVersion	2.0
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\4.0\	DefaultToolsVersion	2.0

Následující klíče registru zadejte instalační cestu rozhraní.NET Framework verze, které jsou spojeny s každou ToolsVersion.Instalační cesta také určuje umístění souboru MSBuild.exe, který definuje sadu nástrojů informace.

Podregistr registru	Název klíče	Hodnota řetězce klíčů
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\ToolsVersions\2.0\	MSBuildToolsPath	Cesta pro instalaci 2.0 rozhraní.NET Framework
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\ToolsVersions\3.5\	MSBuildToolsPath	Cesta pro instalaci 3.5 rozhraní.NET Framework
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\ToolsVersions\4.0\	MSBuildToolsPath	Cesta pro instalaci 4 rozhraní.NET Framework

Modulové Sub

Pokud podklíč klíče registru v předchozí tabulce, použije nástroj MSBuild určit cestu sub nástrojů, který obsahuje další nástroje.Zde je příklad následující podklíč:

\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\ToolsVersions\4.0\11.0

VisualStudioVersion Sestavení vlastnost označuje, zda je sada nástrojů sub stane aktivní.Například VisualStudioVersion sub-sada nástrojů rozhraní .NET Framework 4.5 Určuje hodnotu "11.0".Další informace naleznete v části modulové Sub Sada nástrojů MSBuild (atribut ToolsVersion).

[!POZNÁMKA]

Doporučujeme vyhnout se změna těchto nastavení.Můžete však přidat vlastní nastavení a definovat další oddíl popisuje definice vlastní toolset celého systému.

Definice vlastní sadu nástrojů

Při standardní Toolset nesplňuje požadavky na sestavení, můžete vytvořit vlastní sadu nástrojů.Může mít například scénář laboratoř sestavení musí mít samostatný systém pro stavební Visual C++ projektů.Pomocí vlastních nástrojů můžete přiřadit vlastní hodnoty ToolsVersion při vytváření projektů nebo spuštění MSBuild.exe atribut. Tímto způsobem můžete také použít $(MSBuildToolsPath) vlastnost souborech TARGETS importovat z adresáře.

Zadat vlastní sady nástrojů v konfiguračním souboru MSBuild.exe (nebo pro vlastní nástroj, který je hostitelem MSBuild motoru, pokud je to, co používáte).Konfiguračního souboru MSBuild.exe může například obsahovat následující definici sady nástrojů.

<msbuildToolsets default="3.0">
   <toolset toolsVersion="4.0">
      <property name="MSBuildToolsPath" 
        value="C:\Windows\Microsoft .NET\Framework\v3.0" />
   </toolset>
</msbuildToolsets>

<msbuildToolsets>musí být také definovány v konfiguračním souboru takto.

<configSections>
   <section name="msbuildToolsets"       
       Type="Microsoft.Build.BuildEngine.ToolsetConfigurationSection, 
       Microsoft.Build.Engine, Version=3.5.0.0, Culture=neutral, 
       PublicKeyToken=b03f5f7f11d50a3a"
   </section>
</configSections>

[!POZNÁMKA]

Číst správně, <configSections> musí být první pododdíl v <configuration> oddílu.

ToolsetConfigurationSectionje vlastní konfigurační oddíl, který lze použít libovolný hostitel pro vlastní konfigurace.Pokud použijete vlastní sadu nástrojů, nemá podnikat inicializovat modul sestavení s výjimkou poskytují konfigurace položky souboru hostitele.Definováním položky registru můžete určit modulové celého systému, který použije MSBuild.exe, Visual Studioa všechny hostitele MSBuild.

[!POZNÁMKA]

Pokud konfigurační soubor definuje nastavení ToolsVersion , již byla definována v registru, dvě definice nejsou sloučeny.Definice v konfiguračním souboru má přednost a nastavení v registru pro danou ToolsVersion jsou ignorovány.

Následující vlastnosti jsou určité hodnoty ToolsVersion je v projektech:

$(MSBuildBinPath) nastavena ToolsPath hodnotu, která je určena v registru nebo v konfiguračním souboru kde ToolsVersion je definován.$(MSBuildToolsPath) Nastavení v registru nebo v konfiguračním souboru Určuje umístění sadu nástrojů.V souboru projektu toto mapování vlastnosti $(MSBuildBinPath) a $(MSBuildToolsPath) vlastnosti.
$(MSBuildToolsPath) je rezervovaná vlastnost, která dodává MSBuildToolsPath vlastnost, která je určena v konfiguračním souboru.(Tato vlastnost nahradí $(MSBuildBinPath).Však $(MSBuildBinPath) kompatibility provádí vpřed.)

Můžete také přidat vlastní vlastnosti specifické pro ToolsVersion do konfiguračního souboru pomocí stejné syntaxe, která slouží k přidání vlastnosti MSBuildToolsPath.Zpřístupnit tyto vlastní vlastnosti souboru projektu, použijte stejný název jako název hodnoty zadané v konfiguračním souboru.

Viz také

Koncepty

Sada nástrojů MSBuild (atribut ToolsVersion)

Sdílet prostřednictvím