Standardmäßige und benutzerdefinierte Toolsetkonfigurationen

Ein MSBuild-Toolset enthält Verweise auf Aufgaben, Zielen und Tools, die Sie verwenden können, um ein Anwendungsprojekt zu erstellen. MSBuild umfasst ein Standardtoolset, Sie können jedoch auch benutzerdefinierte Toolsets erstellen. Informationen zum Angeben eines Toolsets finden Sie unter MSBuild-Toolset (ToolsVersion).

Standard-Toolsetkonfigurationen

MSBuild 12.0 umfasst die folgenden Standardtoolsets:

Der ToolsVersion-Wert bestimmt, welches Toolset von einem Projekt verwendet wird, das von Visual Studio generiert wird. In Visual Studio 2013 ist der Standardwert "12.0" (unabhängig von der Version in der Projektdatei), aber Sie können dieses Attribut überschreiben, indem Sie den /toolsversion-Schalter an einer Eingabeaufforderung verwenden. Weitere Informationen über dieses Attribut und andere Methoden, die ToolsVersion anzugeben, finden Sie unter Überschreiben von ToolsVersion-Einstellungen.

Wenn ToolsVersion nicht angegeben ist, definiert der Registrierungsschlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\<Versionsnummer>\DefaultToolsVersion die ToolsVersion, die immer 2.0 lautet.

Die folgenden Registrierungsschlüssel geben den Installationspfad von MSBuild.exe an.

Unter-Toolsets

Wenn der Registrierungsschlüssel in der vorherigen Tabelle über einen Unterschlüssel verfügt, verwendet MSBuild diesen, um den Pfad eines Unter-Toolsets zu bestimmen, der den Pfad im übergeordneten Toolset überschreiben kann. Der folgende Unterschlüssel ist ein Beispiel:

\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\ToolsVersions\12.0\12.0

Falls Eigenschaften sowohl im Basistoolset als auch in den ausgewählten Unter-Toolsets definiert sind, werden die Eigenschaftendefinitionen im Unter-Toolset verwendet. Beispielsweise definiert das Toolset MSBuild 4.0 SDK40ToolsPath so, dass es auf das 7.0A SDK verweist, aber das Toolset MSBuild 4.0\11.0 definiert die gleiche Eigenschaft so, dass sie auf das 8.0A SDK verweist. Wenn VisualStudioVersion nicht festgelegt ist, verweist SDK40ToolsPath auf 7.0A, aber wenn VisualStudioVersion auf 11.0 festgelegt ist, verweist die Eigenschaft stattdessen auf 8.0A.

Die VisualStudioVersion-Buildeigenschaft gibt an, ob ein Unter-Toolset aktiv wird. Beispielsweise gibt der VisualStudioVersion-Wert "12.0" das MSBuild 12.0-Unter-Toolset an. Weitere Informationen finden Sie im Abschnitt zu Unter-Toolsets unter MSBuild-Toolset (ToolsVersion).

Benutzerdefinierte Toolsetdefinitionen

Wenn ein Standardtoolset die Buildanforderungen nicht erfüllt, können Sie ein benutzerdefiniertes Toolset erstellen. Möglicherweise haben Sie ein Buildlaborszenario, in dem Sie über ein eigenes System zum Erstellen von Visual C++-Projekten verfügen müssen. Indem Sie ein benutzerdefiniertes Toolset verwenden, können Sie dem ToolsVersion-Attribut benutzerdefinierte Werte zuweisen, wenn Sie Projekte erstellen oder MSBuild.exe ausführen. Auf diese Weise können Sie die $(MSBuildToolsPath)-Eigenschaft verwenden, um TARGETS-Dateien von diesem Verzeichnis zu importieren, sowie benutzerdefinierte Toolseteigenschaften definieren, die für jedes Projekt verwendet werden können, das dieses Toolset verwendet.

Geben Sie ein benutzerdefiniertes Toolset in der Konfigurationsdatei für MSBuild.exe an (oder für das benutzerdefinierte Tool, das die MSBuild-Engine hostet, wenn dies bei Ihnen zutrifft). Beispielsweise kann die Konfigurationsdatei für MSBuild.exe die folgende Toolsetdefinition enthalten, wenn Sie das Standardverhalten von ToolsVersion 12.0 überschreiben möchten.

<msbuildToolsets default="12.0">
   <toolset toolsVersion="12.0">
      <property name="MSBuildToolsPath" 
        value="C:\SpecialPath" />
   </toolset>
</msbuildToolsets>

<msbuildToolsets> muss auch wie folgt in der Konfigurationsdatei definiert werden.

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

ToolsetConfigurationSection ist ein benutzerdefinierter Konfigurationsabschnitt, der von jedem MSBuild-Host für die benutzerdefinierte Konfiguration verwendet werden kann. Wenn Sie ein benutzerdefiniertes Toolset verwenden, muss ein Host keine Aktionen durchführen, um das Buildmodul zu initialisieren, sondern nur die Einträge in der Konfigurationsdatei zur Verfügung stellen. Indem Sie Einträge in der Registrierung definieren, können Sie computerübergreifende Toolsets angeben, die für MSBuild.exe, Visual Studio und alle Hosts von MSBuild angewendet werden können.

Die folgenden Eigenschaften sind für den Wert der ToolsVersion, die in Projekten verwendet wird, spezifisch:

• $(MSBuildBinPath) ist auf den ToolsPath-Wert festgelegt, der entweder in der Registrierung oder in der Konfigurationsdatei festgelegt ist, in der die ToolsVersion definiert ist. Die $(MSBuildToolsPath)-Einstellung in der Registrierung oder die Konfigurationsdatei gibt den Speicherort der Kernaufgaben und Ziele an. In der Projektdatei wird dies der $(MSBuildBinPath)-Eigenschaft sowie der $(MSBuildToolsPath)-Eigenschaft zugeordnet.

• $(MSBuildToolsPath) ist eine reservierte Eigenschaft von der MSBuildToolsPath-Eigenschaft, die in der Konfigurationsdatei festgelegt ist. (Diese Eigenschaft ersetzt $(MSBuildBinPath). $(MSBuildBinPath) steht aus Kompatibilitätsgründen weiterhin zur Verfügung.) Ein benutzerdefiniertes Toolset muss entweder $(MSBuildToolsPath) oder $(MSBuildBinPath) definieren, jedoch nicht beides, es sei denn, beide haben denselben Wert.

Sie können auch benutzerdefinierte, Toolsversion-spezifische Eigenschaften zur Konfigurationsdatei hinzufügen, indem Sie die gleiche Syntax verwenden wie zum Hinzufügen der MSBuildToolsPath-Eigenschaft. Damit diese benutzerdefinierten Eigenschaften der Projektdatei zur Verfügung stehen, müssen Sie den gleichen Namen wie der des in der Konfigurationsdatei angegebenen Werts verwenden. In der Konfigurationsdatei können Sie Toolsets, nicht jedoch Unter-Toolsets definieren.

Siehe auch

Konzepte

MSBuild-Toolset (ToolsVersion)