Share via

Переопределение параметров ToolsVersion

  • Статья

Атрибут ToolsVersion элемента Project в Файлах проекта Visual Studio и MSBuild считается устаревшим в Visual Studio 2019 и более поздних версиях. Его можно безопасно удалить. В этой статье описывается его использование в более ранних версиях MSBuild или для пользовательских наборов инструментов. См . стандартные и настраиваемые конфигурации набора инструментов.

Набор инструментов для проектов и решений можно изменить одним из трех способов:

  1. Используя параметр -ToolsVersion (или сокращенно -tv) при сборке проекта или решения из командной строки.

  2. Задав параметр ToolsVersion для задачи MSBuild.

  3. Задав свойство $(ProjectToolsVersion) для проекта в решении. Это позволяет собирать проект в решении с версией набора инструментов, отличающейся от используемой в других проектах.

Переопределение параметров ToolsVersion для проектов и решений, собираемых из командной строки

Хотя в проектах Visual Studio параметр ToolsVersion при сборке обычно задается в файле проекта, можно с помощью параметра командной строки -ToolsVersion (или -tv) переопределить это значение и построить все проекты и зависимости между ними с использованием другого набора инструментов. Например:

msbuild.exe someproj.proj -tv:12.0 -p:Configuration=Debug

В этом примере построение всех проектов выполняется с использованием значения ToolsVersion 12.0. (Ознакомьтесь также с разделом Порядок приоритетов далее в этой статье.)

Если в командной строке используется параметр -tv, можно в отдельных проектах использовать дополнительно свойство $(ProjectToolsVersion), чтобы создать их с другим значением ToolsVersion по сравнению с остальными проектами в решении.

Переопределение параметров ToolsVersion с помощью параметра ToolsVersion в задаче MSBuild

Задача MSBuild — основное средство для создания одного проекта из другого. Чтобы в задаче MSBuild можно было создать проект со значением ToolsVersion, отличающимся от значения, заданного в проекте, предоставляется дополнительный параметр задачи с именем ToolsVersion. В следующем примере демонстрируется применение этого параметра.

  1. Создайте файл с именем projectA.proj и добавьте в него следующий код:

    <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003"
ToolsVersion="12.0">

    <Target Name="go" >
        <Message Text="projectA.proj" />
        <Message Text="MSBuildToolsVersion: $(MSBuildToolsVersion)" />
        <Message Text="MSBuildToolsPath:    $(MSBuildToolsPath)" />

        <MSBuild Projects="projectB.proj"
            ToolsVersion="2.0"
            Targets="go" />
    </Target>
</Project>

  2. Создайте файл с именем projectB.proj и добавьте в него следующий код:

    <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003"
ToolsVersion="12.0">

    <Target Name="go">
        <Message Text="projectB.proj" />
        <Message Text="MSBuildToolsVersion: $(MSBuildToolsVersion)" />
        <Message Text="MSBuildToolsPath:    $(MSBuildToolsPath)" />
    </Target>
</Project>

  3. В командной строке введите следующую команду.

    msbuild projectA.proj -t:go -toolsversion:3.5

  4. Появится следующий результат. Для projectA параметр -toolsversion:3.5 в командной строке переопределяет параметр ToolsVersion=12.0 в теге Project.

    Метод ProjectB вызывается задачей в projectA. Эта задача имеет параметр ToolsVersion=2.0, который переопределяет другие параметры ToolsVersion для projectB.

    Output:
  projectA.proj
  MSBuildToolsVersion: 3.5
  MSBuildToolsPath:    C:\Windows\Microsoft.NET\Framework\v3.5

  projectB.proj
  MSBuildToolsVersion: 2.0
  MSBuildToolsPath:    C:\Windows\Microsoft.NET\Framework\v2.0.50727

Порядок приоритетов

В следующем списке показан порядок приоритетов от самого высокого до самого низкого: ToolsVersion

  1. Атрибут ToolsVersion в задаче MSBuild, используемой для сборки проекта (если имеется).

  2. Параметр -toolsversion (или -tv), который используется в команде msbuild.exe, если таковой имеется.

  3. Если задана переменная среды MSBUILDTREATALLTOOLSVERSIONSASCURRENT, используйте текущий параметр ToolsVersion.

  4. Если задана переменная среды MSBUILDTREATHIGHERTOOLSVERSIONASCURRENT и в файле проекта определен параметр ToolsVersion больший, чем текущий параметр ToolsVersion, используйте текущий параметр ToolsVersion.

  5. Если задана переменная среды MSBUILDLEGACYDEFAULTTOOLSVERSION или если не задан параметр ToolsVersion, используются следующие действия.

    1. Атрибут ToolsVersion элемента Project в файле проекта. Если этот атрибут не существует, предполагается, что используется текущая версия.

    2. Версия набора инструментов, заданная по умолчанию в файле MSBuild.exe.config.

    3. Версия набора инструментов, заданная по умолчанию в реестре. Дополнительные сведения см. в статье Стандартные и настраиваемые конфигурации наборов инструментов.

  6. Если переменная среды MSBUILDLEGACYDEFAULTTOOLSVERSION не задана, используются следующие действия.

    1. Если переменная среды MSBUILDDEFAULTTOOLSVERSION задана равной существующему параметру ToolsVersion, используйте ее.

    2. Если свойство DefaultOverrideToolsVersion задано в MSBuild.exe.config, используйте его.

    3. Если в реестре задано свойство DefaultOverrideToolsVersion, используйте его.

    4. В противном случае используйте текущий параметр ToolsVersion.

Связанный контент