Задача TestToolsTask
Обновлен: Ноябрь 2007
Задача TestToolsTask выполняет тесты для сквозных или локальных построений. Тип локального построения можно выбрать, установив свойство IsDesktopBuild в значение true.
Параметры
Свойство |
Описание |
---|---|
Condition |
Необязательный параметр типа String. Выражение типа Boolean, используемое ядром MSBuild для определения того, будет ли выполняться данная задача. См. сведения в разделе Условия MSBuild. |
BuildFlavor |
Задает конфигурацию построения. Например, «Отладка». Определено только для сквозных (не локальных) построений. |
Platform |
Задает платформу. Например, x86 или «Любой ЦП». Определено только для сквозных (не локальных) построений. |
PublishServer |
Задает URL-адрес Team Foundation Server. Определено только для сквозных (не локальных) построений. |
PublishBuild |
Задает номер построения. Определено только для сквозных (не локальных) построений. |
SearchPathRoot |
Задает путь поиска для файлов тестов. Определено для сквозных и локальных построений. |
PathToResultsFilesRoot |
Задает расположение, куда загружаются результаты тестов. Определено для сквозных и локальных построений. |
MetaDataFile |
Задает файл метаданных тестов. Файл содержит списки тестов и ссылки на тесты. Дополнительные сведения о списках тестов см. в разделе Использование списков тестов. Файлы метаданных тестов имеют расширение .vsmdi. Определено для сквозных и локальных построений. |
RunConfigFile |
Задает файл конфигурации теста. Эти файлы определяют конфигурацию выполнения тестов. Дополнительные сведения см. в разделе Настройка выполнения теста. Файлы тестовых запусков имеют расширение .testrunconfig. Определено для сквозных и локальных построений. |
TestLists |
Определяет список тестов, содержащийся в файле метаданных тестов. Определено для сквозных и локальных построений. |
TeamProject |
Задает имя командного проекта. Определено только для сквозных (не локальных) построений. |
TestContainers |
Задает файл, содержащий тесты. Пример: myTestFile.dll. |
Заметки
Файл Microsoft.TeamFoundation.Build.targets содержит экземпляр задачи TestToolsTask, которую Team Foundation Build использует как реализацию по умолчанию для целевого объекта RunTestWithConfiguration.
Файл Microsoft.TeamFoundation.Build.targets хранится в папке <корень>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild на компьютере с Team Foundation Build.
Пример
Приведенный ниже код XML описывает экземпляры задачи TestToolsTask в файле Microsoft.TeamFoundation.Build.targets, которые используются при сквозных построениях.
<!-- MetaDataFile tests for non-desktop builds. -->
<TestToolsTask
Condition=" '$(IsDesktopBuild)'!='true' and '%(LocalMetaDataFile.Identity)' != '' "
BuildFlavor="$(Configuration)"
Platform="$(Platform)"
PublishServer="$(TeamFoundationServerUrl)"
PublishBuild="$(BuildNumber)"
SearchPathRoot="$(OutDir)"
PathToResultsFilesRoot="$(TestResultsRoot)"
MetaDataFile="%(LocalMetaDataFile.Identity)"
RunConfigFile="$(RunConfigFile)"
TestLists="%(LocalMetaDataFile.TestList)"
TeamProject="$(TeamProject)"
ContinueOnError="true" />
<!-- TestContainer tests for non-desktop builds. -->
<TestToolsTask
Condition=" '$(IsDesktopBuild)'!='true' and '%(LocalTestContainer.Identity)' != '' "
BuildFlavor="$(Configuration)"
Platform="$(Platform)"
PublishServer="$(TeamFoundationServerUrl)"
PublishBuild="$(BuildNumber)"
SearchPathRoot="$(OutDir)"
PathToResultsFilesRoot="$(TestResultsRoot)"
RunConfigFile="$(RunConfigFile)"
TestContainers="%(LocalTestContainer.Identity)"
TeamProject="$(TeamProject)"
ContinueOnError="true" />
Приведенный ниже код XML описывает экземпляры задачи TestToolsTask в файле Microsoft.TeamFoundation.Build.targets, которые используются для локального построения.
<!-- MetaDataFile tests for desktop builds. -->
<TestToolsTask
Condition=" '$(IsDesktopBuild)'=='true' and '%(MetaDataFile.Identity)' != '' "
SearchPathRoot="$(OutDir)"
PathToResultsFilesRoot="$(TestResultsRoot)"
MetaDataFile="%(MetaDataFile.Identity)"
RunConfigFile="$(RunConfigFile)"
TestLists="%(MetaDataFile.TestList)"
ContinueOnError="true" />
<!-- TestContainer tests for desktop builds. -->
<TestToolsTask
Condition=" '$(IsDesktopBuild)'=='true' and '%(TestContainer.Identity)' != '' "
SearchPathRoot="$(OutDir)"
PathToResultsFilesRoot="$(TestResultsRoot)"
RunConfigFile="$(RunConfigFile)"
TestContainers="%(TestContainer.Identity)"
ContinueOnError="true" />
См. также
Задачи
Практическое руководство. Настройка и запуск тестов проверки построения
Практическое руководство. Настройка тестов с определениями построений