TestToolsTask-Aufgabe

  • Artikel

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

Property

Beschreibungen

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 Hochladen 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 Configuring How to Run Your Tests from Microsoft Visual Studio. 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 geplanten Tests nach dem Erstellen der Anwendung

Anpassen von Buildnummern

Weitere Ressourcen

Ziele, Aufgaben und Eigenschaften von Team Foundation Build