TestToolsTask タスク
更新 : 2007 年 11 月
TestToolsTask タスクは、エンド ツー エンド ビルドまたはデスクトップ ビルドを対象としてテストを実行します。デスクトップ ビルドの種類を設定するには、IsDesktopBuild プロパティを true に設定します。
パラメータ
プロパティ |
説明 |
|---|---|
Condition |
省略可能な String 型のパラメータです。 このタスクを実行するかどうかを MSBuild エンジンで決定するための Boolean 式です。詳細については、「MSBuild の条件」を参照してください。 |
BuildFlavor |
ビルドの構成を指定します。たとえば、"Debug" を指定します。 エンド ツー エンド ビルドにのみ適用されます (デスクトップ ビルドには適用されません)。 |
Platform |
プラットフォームを指定します。たとえば、"x86" や "Any CPU" です。 エンド ツー エンド ビルドにのみ適用されます (デスクトップ ビルドには適用されません)。 |
PublishServer |
Team Foundation Server の URL を指定します。 エンド ツー エンド ビルドにのみ適用されます (デスクトップ ビルドには適用されません)。 |
PublishBuild |
このビルドのビルド番号を指定します。 エンド ツー エンド ビルドにのみ適用されます (デスクトップ ビルドには適用されません)。 |
SearchPathRoot |
テスト ファイルの検索パスを指定します。 エンド ツー エンド ビルドおよびデスクトップ ビルドに適用されます。 |
PathToResultsFilesRoot |
テスト結果をアップロードする場所を指定します。 エンド ツー エンド ビルドおよびデスクトップ ビルドに適用されます。 |
MetaDataFile |
テスト メタデータ ファイルを指定します。このファイルには、テスト リストとテストへのリンクが含まれています。テスト リストの詳細については、「テスト リストの使用」を参照してください。テスト メタデータ ファイルには、拡張子 .vsmdi が付いています。 エンド ツー エンド ビルドおよびデスクトップ ビルドに適用されます。 |
RunConfigFile |
テスト構成ファイルを指定します。これらのファイルにテストの実行方法を定義します。詳細については、「テスト実行の構成」を参照してください。テスト実行構成ファイルには、拡張子 .testrunconfig が付いています。 エンド ツー エンド ビルドおよびデスクトップ ビルドに適用されます。 |
TestLists |
テスト メタデータ ファイルに含まれているテスト リストを指定します。 エンド ツー エンド ビルドおよびデスクトップ ビルドに適用されます。 |
TeamProject |
チーム プロジェクトの名前を指定します。 エンド ツー エンド ビルドにのみ適用されます (デスクトップ ビルドには適用されません)。 |
TestContainers |
テストが含まれるファイルを指定します。たとえば、"myTestFile.dll" のように指定します。 |
解説
Microsoft.TeamFoundation.Build.targets ファイルには、Team Foundation ビルドが RunTestWithConfiguration ターゲット用の既定の実装として使用する TestToolsTask タスクのインスタンスが含まれています。
Microsoft.TeamFoundation.Build.targets ファイルは、Team Foundation ビルド コンピュータの <root>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild フォルダに格納されています。
使用例
次の XML は、エンド ツー エンド ビルドで使用される Microsoft.TeamFoundation.Build.targets ファイル内の TestToolsTask のインスタンスを示しています。
<!-- 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 は、デスクトップ ビルドで使用される Microsoft.TeamFoundation.Build.targets ファイル内の TestToolsTask のインスタンスを示しています。
<!-- 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" />
参照
処理手順
方法 : ビルド検証テスト (BVT) を構成および実行する