VisualStudioTestPlatformInstaller@1 - Visual Studio テスト プラットフォーム インストーラー v1 タスク

  • [アーティクル]

このタスクを使用して、nuget.org または指定したフィードから Microsoft テスト プラットフォーム を取得し、ツール キャッシュに追加します。 インストーラー タスクは需要を vstest 満たし、ビルドまたはリリース パイプライン内の後続の Visual Studio テスト タスクは、エージェント コンピューターに Visual Studio を完全にインストールしなくても実行できます。

構文

# Visual Studio test platform installer v1
# Acquire the test platform from nuget.org or the tool cache. Satisfies the ‘vstest’ demand and can be used for running tests and collecting diagnostic data using the Visual Studio Test task.
- task: VisualStudioTestPlatformInstaller@1
  inputs:
  # Package settings
    packageFeedSelector: 'nugetOrg' # 'nugetOrg' | 'customFeed' | 'netShare'. Required. Package Feed. Default: nugetOrg.
    #versionSelector: 'latestPreRelease' # 'latestPreRelease' | 'latestStable' | 'specificVersion'. Required when packageFeedSelector = nugetOrg || packageFeedSelector = customFeed. Version. Default: latestPreRelease.
    #testPlatformVersion: # string. Required when versionSelector = specificVersion. Test Platform Version. 
    #customFeed: # string. Required when packageFeedSelector = customFeed. Package Source. 
    #username: # string. Optional. Use when packageFeedSelector = customFeed. User Name. 
    #password: # string. Optional. Use when packageFeedSelector = customFeed. Password. 
    #netShare: # string. Required when packageFeedSelector = netShare. UNC Path.

# Visual Studio Test Platform Installer v1
# Acquires the test platform from nuget.org or the tools cache. Satisfies the ‘vstest’ demand and can be used for running tests and collecting diagnostic data using the Visual Studio Test task.
- task: VisualStudioTestPlatformInstaller@1
  inputs:
  # Package settings
    packageFeedSelector: 'nugetOrg' # 'nugetOrg' | 'customFeed' | 'netShare'. Required. Package Feed. Default: nugetOrg.
    #versionSelector: 'latestPreRelease' # 'latestPreRelease' | 'latestStable' | 'specificVersion'. Required when packageFeedSelector = nugetOrg || packageFeedSelector = customFeed. Version. Default: latestPreRelease.
    #testPlatformVersion: # string. Required when versionSelector = specificVersion. Test Platform Version. 
    #customFeed: # string. Required when packageFeedSelector = customFeed. Package Source. 
    #username: # string. Optional. Use when packageFeedSelector = customFeed. User Name. 
    #password: # string. Optional. Use when packageFeedSelector = customFeed. Password. 
    #netShare: # string. Required when packageFeedSelector = netShare. UNC Path.

入力

packageFeedSelector - パッケージ フィード
string. 必須です。 使用できる値: nugetOrg (公式 Nuget)、 customFeed (カスタム フィード)、 netShare (ネットワーク パス)。 既定値: nugetOrg。

タスクが Visual Studio Test Platform NuGet パッケージをフェッチするフィードを指定します。

nugetOrg - 公式 NuGet: NuGet からテスト プラットフォーム パッケージを取得します。 このオプションを使用するには、エージェント コンピューターでインターネット接続が必要です。

customFeed - カスタム フィード: Azure DevOps または TFS のカスタム フィードまたはパッケージ管理フィードからテスト プラットフォーム パッケージを取得します。

netShare - ネットワーク パス: ネットワーク共有からテスト プラットフォームをインストールします。 指定した Microsoft.TestPlatform.nupkg バージョンは NuGet からダウンロードし、ビルド/リリース エージェントがアクセスできるネットワーク共有に配置する必要があります。


versionSelector - バージョン
string. packageFeedSelector = nugetOrg || packageFeedSelector = customFeed の場合に必要です。 使用できる値: latestPreRelease (最新 (プレリリースを含む)、 latestStable (最新の安定版)、 specificVersion (特定のバージョン)。 既定値: latestPreRelease。

Visual Studio Test Platform の最新バージョンまたは特定のバージョンをインストールします。 テスト プラットフォーム インストーラーを使用してコード化された UI テストを実行する場合、選択した Visual Studio テスト プラットフォームは、テスト バイナリをビルドした Visual Studio インストールのメジャー バージョンと一致する必要があります。 たとえば、コード化された UI テスト プロジェクトが Visual Studio 2017 (バージョン 15.x) を使用してビルドされた場合は、Test Platform バージョン 15.x を使用する必要があります。


testPlatformVersion - プラットフォーム のバージョンをテストする
string. versionSelector = specificVersion の場合に必要です。

エージェントにインストールする Visual Studio テスト プラットフォームのバージョンを指定します。 使用可能なバージョンは 、NuGet で表示できます。


customFeed - パッケージ ソース
string. packageFeedSelector = customFeed の場合に必要です。

テスト プラットフォーム パッケージを含む Azure DevOps または TFS のカスタム フィードまたはパッケージ管理フィードの URL を指定します。 パブリック フィードとプライベート フィードを指定できます。


username - ユーザー名
string. 省略可能。 の場合は packageFeedSelector = customFeedを使用します。

Package Source 引数で指定されたフィードを認証するユーザー名を指定します。 入力で個人用アクセス トークン (PAT) が使用されている password 場合、この入力は必要ありません。


password - パスワード
string. 省略可能。 の場合は packageFeedSelector = customFeedを使用します。

入力で指定されたフィードを認証するためのパスワードまたは個人用アクセス トークン (PAT) を customFeed 指定します。


netShare - UNC パス
string. packageFeedSelector = netShare の場合に必要です。

ファイルへの完全な UNC パスを Microsoft.TestPlatform.nupkg 指定します。 指定した Microsoft.TestPlatform.nupkg バージョンは NuGet からダウンロードし、ビルド/リリース エージェントがアクセスできるネットワーク共有に配置する必要があります。


タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

解説

注意

ホストされているエージェントを使用している場合は、使用しているエージェントのソフトウェア テーブルをチェックして、Visual Studio がインストールされているかどうかを確認します。 Visual Studio がインストールされている場合は、Visual Studio テスト プラットフォーム インストーラー タスクを実行する必要はありません。

このタスクを使用して、nuget.org または指定したフィードから Microsoft テスト プラットフォーム を取得し、ツール キャッシュに追加します。 インストーラー タスクは需要を vstest 満たし、ビルドまたはリリース パイプライン内の後続の Visual Studio テスト タスク は、エージェント コンピューターに Visual Studio を完全にインストールしなくても実行できます。

注意

  • Visual Studio テスト プラットフォーム インストーラー タスクは、ビルドまたはリリース パイプラインの Visual Studio テスト タスクの前に表示する必要があります。
  • Visual Studio テスト タスクの [Test platform version]\(プラットフォームのバージョンのテスト\) オプションは、[Installed by Tools Installer]\(ツール インストーラーによってインストール済み\) に設定する必要があります。

「 テスト 計画から自動テストを実行する」を参照してください。

要件

要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
実行日 エージェント、DeploymentGroup
確認要求 なし
Capabilities このタスクを実行すると、同じジョブ内の後続のタスクに対して次の 要求 が満たされます: VsTest
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン 2.144.0 以上
タスクのカテゴリ ツール
要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
実行日 エージェント、DeploymentGroup
確認要求 なし
Capabilities このタスクを実行すると、同じジョブ内の後続のタスクに対して次の 要求 が満たされます: VsTest
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン 2.103.0 以上
タスクのカテゴリ ツール