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

MSBuild Toolset başvuru görevler, hedefler ve uygulama projesi 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ı

MSBuild 12.0 aşağıdaki standart Toolsets içerir:

ToolsVersion Değeri belirler, araç tarafından kullanılan Visual Studio'nun oluşturduğu bir proje.İçinde Visual Studio 2013 varsayılan değer "12.0" (olursa olsun proje dosyasında belirtilen hangi sürümü), ancak bu özniteliği kullanılarak kılabilirsiniz /toolsversion bir komut istemine geçin.Bu öznitelik ve belirtmek için diğer yolları hakkında bilgi için ToolsVersion, bkz: ToolsVersion Ayarlarını Geçersiz Kılma.

Yoksa ToolsVersion belirlenmezse, kayıt defteri anahtarı HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\<sürüm numarası>\DefaultToolsVersion tanımlayan ToolsVersion, olduğu her zaman 2.0.

Aşağıdaki kayıt defteri anahtarlarını MSBuild.exe'yi yükleme konumunu belirtin.

Sub-toolsets

Önceki tabloda kayıt defteri anahtarının bir alt anahtarı varsa, MSBuild, alt araç yolunun üst toolset yolunda geçersiz kılabilir belirlemek için kullanır.Aşağıdaki alt anahtarı bir örnek verilmiştir:

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

Tüm özellikleri hem temel araç takımı hem de seçilen alt toolset tanımlanmışsa, araç takımı alt özellik tanımlarında kullanılır.Örneğin, MSBuild 4.0 toolset tanımlar SDK40ToolsPath .0a SDK, ancak MSBuild işaret edecek şekilde 4.0\11.0 araç takımı 8.0a için işaret edecek şekilde aynı özelliği tanımlar SDK.Yoksa VisualStudioVersion ayarlanmamış, SDK40ToolsPath , ancak 7.0a için işaret VisualStudioVersion özelliği yerine 8.0a için işaret 11.0 için ayarlanır.

VisualStudioVersion Yapı özelliği, alt toolset etkin olacağını gösterir.Örneğin, bir VisualStudioVersion sub-toolset MSBuild 12.0 "12.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 bir sonraki bölümde açıklandığı gibi bilgisayar genelindeki özel araç takımı, tanım.

Özel araç kümesi tanımları

Standart araç takımı, bir yapı gereksinimlerini yerine getirmiyor, özel bir araç kümesi oluşturabilirsiniz.Örneğin, bir yapı Laboratuvar senaryo içinde olması gerekir oluşturmak için ayrı bir sistem olabilir Visual C++ projeleri.Özel bir araç takımı kullanılarak için özel değerler atamak için ToolsVersion özniteliğini projeler oluşturduğunuzda veya MSBuild.exe'yi çalıştırın.Bunu yaparken de kullanabilirsiniz $(MSBuildToolsPath) .targets dosyaları bu dizine, aynı zamanda bu araç kullanan herhangi bir proje için kullanılan kendi özel araç özellikleri tanımlamaya almak için özellik.

Özel bir araç kümesi yapılandırma dosyasında MSBuild.exe'yi (veya kullanmakta olduğunuz ise, MSBuild altyapısı barındıran özel bir araç) belirtin.ToolsVersion 12.0 varsayılan davranışı geçersiz kılmak istediğinizde örneğin MSBuild.exe'yi yapılandırma dosyası aşağıdaki Toolset tanımı içerir.

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

<msbuildToolsets>Ayrıca yapılandırma dosyasında aşağıdaki gibi tanımlanmış olması gerekir.

<configSections>
   <section name="msbuildToolsets"       
       Type="Microsoft.Build.BuildEngine.ToolsetConfigurationSection, 
       Microsoft.Build.Engine, Version=12.0.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 MSBuild ana tarafından özel yapılandırma için kullanılabilecek bir özel yapılandırma bölümüdür.Özel bir araç kullanıyorsanız, bir ana bilgisayar yapılandırma dosyası girdileri sağlamak dışında yapı altyapısını başlatmak için bir şeye sahip değil.Kayıt defterindeki girişleri 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ı tanımlıyorsa 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 gereken ToolsVersion göz ardı edilir.

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

• $(MSBuildBinPath) ayarlamak ToolsPath kayıt defterinde veya yapılandırma dosyasında belirtilen değeri burada ToolsVersion tanımlanır.$(MSBuildToolsPath) Kayıt defteri veya yapılandırma dosyası ayarı temel görevler ve hedefleri konumunu belirtir.Proje dosyasında bu $(MSBuildBinPath) özelliğine ve $(MSBuildToolsPath) özelliğine eşlenir.

• $(MSBuildToolsPath)yapılandırma dosyasında belirtilen MSBuildToolsPath özelliği tarafından sağlanan ayrılmış bir özelliktir. (Bu özellik yerini alan $(MSBuildBinPath).Ancak, $(MSBuildBinPath) ileriye uyumluluk için uygulanır.) Ya da özel bir araç kümesi tanımlamanız gerekir $(MSBuildToolsPath) veya $(MSBuildBinPath) , ancak ikisi birden değil, her ikisi de aynı değere sahip değilse.

Özel, ToolsVersion özgü özellikler yapılandırma dosyasına MSBuildToolsPath özelliğini eklemek için kullandığınız aynı söz dizimini kullanarak da 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.Yapılandırma dosyasında toolsets ancak sub-toolsets tanımlayabilir.

Ayrıca bkz.

Kavramlar

MSBuild Araç Takımı (ToolsVersion)