Partager via


TestToolsTask, tâche

Mise à jour : novembre 2007

La tâche TestToolsTask exécute les tests pour une build de bout en bout ou une build de bureau. Définissez un type de build de bureau en affectant true à la propriété IsDesktopBuild.

Paramètres

Propriété

Description

Condition

Paramètre String facultatif.

Expression Boolean utilisée par le moteur MSBuild pour déterminer si cette tâche est exécutée. Pour plus d'informations, consultez Conditions MSBuild.

BuildFlavor

Spécifie la configuration de la build. Par exemple, Debug.

Défini uniquement pour la build de bout en bout (et non la build de bureau).

Platform

Spécifie la plateforme. Par exemple, x86 ou Any CPU.

Défini uniquement pour la build de bout en bout (et non la build de bureau).

PublishServer

Spécifie l'URL de Team Foundation Server.

Défini uniquement pour la build de bout en bout (et non la build de bureau).

PublishBuild

Spécifie le numéro de build pour la build.

Défini uniquement pour la build de bout en bout (et non la build de bureau).

SearchPathRoot

Spécifie le chemin de recherche des fichiers test.

Défini pour les builds de bout en bout et de bureau.

PathToResultsFilesRoot

Spécifie où les résultats de tests sont téléchargés.

Défini pour les builds de bout en bout et de bureau.

MetaDataFile

Spécifie le fichier de métadonnées de test. Ce fichier contient des listes de tests et des liens vers des tests. Pour plus d'informations sur les listes de tests, consultez Utilisation des listes de test. Les fichiers de métadonnées de test ont l'extension .vsmdi.

Défini pour les builds de bout en bout et de bureau.

RunConfigFile

Spécifie le fichier de configuration de test. Ces fichiers configurent le mode d'exécution des tests. Pour plus d'informations, consultez Configuration de l'exécution de tests. Les fichiers de configuration de série de tests ont l'extension .testrunconfig.

Défini pour les builds de bout en bout et de bureau.

TestLists

Spécifie la liste de tests qui est contenue dans le fichier de métadonnées de test.

Défini pour les builds de bout en bout et de bureau.

TeamProject

Spécifie le nom du projet d'équipe.

Défini uniquement pour la build de bout en bout (et non la build de bureau).

TestContainers

Spécifie le fichier qui contient les tests. Par exemple, FichierTests.dll.

Notes

Le fichier Microsoft.TeamFoundation.Build.targets contient une instance de la tâche TestToolsTask que Team Foundation Build utilise comme implémentation par défaut pour la cible RunTestWithConfiguration.

Le fichier Microsoft.TeamFoundation.Build.targets est stocké dans le dossier <racine>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild sur l'ordinateur Team Foundation Build.

Exemple

Le code XML suivant décrit les instances de TestToolsTask dans le fichier Microsoft.TeamFoundation.Build.targets, utilisées pour une build de bout en bout.

<!-- 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" />

Le code XML suivant décrit les instances de TestToolsTask dans le fichier Microsoft.TeamFoundation.Build.targets, utilisées pour une build de bureau.

<!-- 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" />

Voir aussi

Tâches

Comment : configurer et exécuter des tests de vérification de la génération

Comment : personnaliser des numéros de build

Comment : configurer les tests en fonction des définitions de build

Concepts

Tâches de Team Foundation Build

Autres ressources

Personnalisation de Team Foundation Build

Cibles, tâches et propriétés de Team Foundation Build