TestToolsTask-Aufgabe
Aktualisiert: November 2007
Mit der TestToolsTask-Aufgabe werden Tests für End-to-End-Builds oder Desktopbuilds ausgeführt. Legen Sie einen Desktopbuildtyp fest, indem Sie die IsDesktopBuild-Eigenschaft auf true festlegen.
Parameter
Eigenschaft |
Beschreibung |
|---|---|
Condition |
Optionaler String-Parameter. Der Boolean-Ausdruck, mit dem vom MSBuild-Modul ermittelt wird, ob diese Aufgabe ausgeführt wird. Weitere Informationen finden Sie unter MSBuild-Bedingungen. |
BuildFlavor |
Gibt die Buildkonfiguration an. Ein Beispiel ist Debuggen. Nur definiert für End-to-End-Build (nicht für Desktopbuild). |
Platform |
Gibt die Plattform an. Beispiel sind x86 und AnyCPU. Nur definiert für End-to-End-Build (nicht für Desktopbuild). |
PublishServer |
Gibt die Team Foundation Server-URL an. Nur definiert für End-to-End-Build (nicht für Desktopbuild). |
PublishBuild |
Gibt die Buildnummer des Builds an. Nur definiert für End-to-End-Build (nicht für Desktopbuild). |
SearchPathRoot |
Gibt den Suchpfad für Testdateien an. Definiert für End-to-End- und Desktopbuilds. |
PathToResultsFilesRoot |
Gibt den Speicherort zum Uploaden von Testergebnissen an. Definiert für End-to-End- und Desktopbuilds. |
MetaDataFile |
Gibt die Testmetadatendatei an. Diese Datei enthält Testlisten und Links zu Tests. Weitere Informationen zu Testlisten finden Sie unter Verwenden von Testlisten. Testmetadatendateien haben die Erweiterung .vsmdi. Definiert für End-to-End- und Desktopbuilds. |
RunConfigFile |
Gibt die Testkonfigurationsdatei an. Mit diesen Dateien wird die Ausführung von Tests konfiguriert. Weitere Informationen finden Sie unter Konfigurieren der Testausführung. Testlaufkonfigurationsdateien haben die Erweiterung .testrunconfig. Definiert für End-to-End- und Desktopbuilds. |
TestLists |
Gibt die in der Testmetadatendatei enthaltene Testliste an. Definiert für End-to-End- und Desktopbuilds. |
TeamProject |
Gibt den Namen des Teamprojekts an. Nur definiert für End-to-End-Build (nicht für Desktopbuild). |
TestContainers |
Gibt die Datei an, die Tests enthält. Beispiel: myTestFile.dll. |
Hinweise
Die Datei Microsoft.TeamFoundation.Build.targets enthält eine Instanz der TestToolsTask-Aufgabe, die von Team Foundation Build als Standardimplementierung für das RunTestWithConfiguration-Ziel verwendet wird.
Die Datei Microsoft.TeamFoundation.Build.targets wird auf dem Team Foundation Build-Computer im Ordner <root>:\Programme\MSBuild\Microsoft\VisualStudio\TeamBuild gespeichert.
Beispiel
Der folgende XML-Code beschreibt die Instanzen von TestToolsTask in der Datei Microsoft.TeamFoundation.Build.targets, die für einen End-to-End-Build verwendet werden.
<!-- 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" />
Der folgende XML-Code beschreibt die Instanzen von TestToolsTask in der Datei Microsoft.TeamFoundation.Build.targets, die für einen Desktopbuild verwendet werden.
<!-- 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" />
Siehe auch
Aufgaben
Gewusst wie: Konfigurieren und Ausführen von Buildüberprüfungstests (Build Verification Test - BVT)
Gewusst wie: Anpassen von Buildnummern
Gewusst wie: Konfigurieren von Tests mit Builddefinitionen
Konzepte
Team Foundation Build-Aufgaben