Standart ve Özel Araç Takımı Yapılandırmaları

Makale
02/26/2013

MSBuild Toolset görevleri, hedefleri ve uygulama projesini oluşturmak için kullanabileceğiniz araçlar içerir.MSBuild standart bir araç kümesi içerir, ancak özel Toolsets de oluşturabilirsiniz.Bir araç kümesi belirtme hakkında daha fazla bilgi için bkz.MSBuild Araç Takımı (ToolsVersion)

Standart araç kümesi yapılandırmaları

MSBuild4.5 aşağıdaki standart Toolsets içerir:

ToolsVersion	Araç Takımı yolunu (MSBuildToolsPath veya MSBuildBinPath yapı özelliği belirtildiği)
2.0	Windows yükleme yolu\Microsoft.Net\Framework\v2.0.50727\
3.5	Windows yükleme yolu\Microsoft.NET\Framework\v3.5.20223\
4.0	Windows yükleme yolu\Microsoft.NET\Framework\v4.0.30319\

ToolsVersion Değeri belirler araç takımı tarafından kullanılan Visual Studio'nun oluşturduğu bir proje.Belirttiğiniz ToolsVersion bir öznitelik olarak Proje proje dosyası, ancak öğesini kullanarak bu özniteliği geçersiz /toolsversion komut istemine geçin.Bu öznitelik, bu anahtarı ve belirtmek için diğer yolları hakkında bilgi için ToolsVersion, bkz: ToolsVersion ayarlarını geçersiz kılma.

ToolsVersion Değil belirtilmezse, aşağıdaki tuşları tanımlamak ToolsVersion.

Kayıt defteri kovanı	Anahtar adı	Dize anahtarı
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\3.5\	DefaultToolsVersion	2.0
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\4.0\	DefaultToolsVersion	2.0

Aşağıdaki kayıt defteri anahtarlarının her ile ilişkili olan .NET Framework sürümlerini yükleme yolunu belirtmek ToolsVersion.Yükleme yolu da Toolset bilgisini tanımlar MSBuild.exe'yi konumunu belirtir.

Kayıt defteri kovanı	Anahtar adı	Dize anahtarı
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\ToolsVersions\2.0\	MSBuildToolsPath	.net framework 2.0 yükleme yolu
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\ToolsVersions\3.5\	MSBuildToolsPath	.net framework 3.5 yükleme yolu
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\ToolsVersions\4.0\	MSBuildToolsPath	.net framework 4'ü yükleme yolu

Alt toolsets

Önceki tabloda kayıt defteri anahtarının bir alt anahtarı varsa, MSBuild, daha fazla araçları içeren bir alt-toolset yolunu belirlemek için kullanır.Aşağıdaki alt anahtarı bir örnektir:

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

VisualStudioVersion Yapı özelliği alt toolset etkin olacağını gösterir.Örneğin, bir VisualStudioVersion .net Framework 4.5 sub toolset "11.0" değerini belirtir.Toolsets alt kısmında daha fazla bilgi için bkz: MSBuild Araç Takımı (ToolsVersion).

[!NOT]

Bu ayarlar değiştirmekten kaçının öneririz.Yine de, kendi ayarlarını ekleyin ve sonraki bölümde açıklandığı gibi bilgisayar genelindeki özel araç kümesi tanımlarını tanımlayın.

Özel araç kümesi tanımları

Standart araç takımı yapı gereksinimlerinizi karşılamak değil, özel bir araç kümesi oluşturabilirsiniz.Örneğin, bir yapı laboratuarı senaryo içinde olması gerekir oluşturmak için ayrı bir sistem olabilir Visual C++ projeleri.Özel araç takımını kullanarak için özel değerler atamak için ToolsVersion özniteliğini projeler oluşturduğunuzda veya MSBuild.exe'yi çalıştırın. Bunu yaparak da kullanabilirsiniz $(MSBuildToolsPath) .targets, diğer dizinden almak için özellik.

Özel bir araç takımı için MSBuild.exe'yi yapılandırma dosyasında belirtin (veya barındıran özel bir araç MSBuild , kullanmakta olduğunuz ise altyapısı).Örneğin, aşağıdaki araç kümesi tanımı MSBuild.exe'yi yapılandırma dosyası içerebilir.

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

<msbuildToolsets>Ayrıca yapılandırma dosyasında aşağıdaki gibi tanımlanmış olmalıdır.

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

[!NOT]

Doğru okumak için <configSections> ilk alt bölümünde olmalıdır <configuration> bölüm.

ToolsetConfigurationSectionherhangi bir ana bilgisayar tarafından özel yapılandırma için kullanılabilecek özel yapılandırma bölümüdür.Özel bir araç takımı'nı kullanırsanız, ana bilgisayar yapılandırma dosyası girdileri sağlamak dışında yapı altyapısını başlatmak için herhangi bir şey yapmak yok.Kayıt defteri girdilerini tanımlayarak uygulamak için MSBuild.exe'yi, bilgisayar genelindeki Toolsets belirtebilirsiniz Visual Studiove tüm ana MSBuild.

[!NOT]

Bir yapılandırma dosyası ayarlarını tanımlar, bir ToolsVersion , önceden tanımlanmış kayıt defterinde, iki tanım birleştirilmez.Yapılandırma dosyası tanımı önceliği ve ayarları kayıt defterinde için geçen ToolsVersion göz ardı edilir.

Aşağıdaki özellikler değerine özgü ToolsVersion yani kullanılan projeler:

$(MSBuildBinPath) ayarlamak ToolsPath kayıt defteri veya yapılandırma dosyasında belirtilen değeri burada ToolsVersion tanımlanır.$(MSBuildToolsPath) Kayıt defteri veya yapılandırma dosyası ayarı Toolset konumunu belirtir.Proje dosyasında bu $(MSBuildBinPath) özelliği ve ayrıca $(MSBuildToolsPath) özelliği eşlenir.
$(MSBuildToolsPath) yapılandırma dosyasında belirtilen MSBuildToolsPath özelliği tarafından sağlanan ayrılmış bir özellik değil.(Bu özellik yerini alan $(MSBuildBinPath).Ancak, $(MSBuildBinPath) ileriye uyumluluk için uygulanır.)

MSBuildToolsPath özelliği eklemek için kullandığınız aynı sözdizimini kullanarak yapılandırma dosyası, ToolsVersion özgü özel özellikler de ekleyebilirsiniz.Bu özel özellikler proje dosyası kullanılabilir hale getirmek için yapılandırma dosyasında belirtilen değerin adı olarak aynı adı kullanın.

Ayrıca bkz.

Kavramlar

MSBuild Araç Takımı (ToolsVersion)

Aracılığıyla paylaş