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 |
テスト構成ファイルを指定します。 これらのファイルにテストの実行方法を定義します。 詳細については、「Microsoft Visual Studio からのテストを実行する方法を構成します。」を参照してください。 テスト実行構成ファイルには、拡張子 .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" />
参照
処理手順
方法: アプリケーションのビルド後にスケジュールされているテストを構成および実行する