VisualStudioTestPlatformInstaller@1 – Visual Studio-Testplattforminstallationsprogramm v1-Aufgabe

Verwenden Sie diese Aufgabe, um die Microsoft-Testplattform aus nuget.org oder einem angegebenen Feed zu erwerben und sie dem Toolscache hinzuzufügen. Die Installationsprogrammaufgabe erfüllt die vstest Anforderung, und eine nachfolgende Visual Studio Test-Aufgabe in einer Build- oder Releasepipeline kann ausgeführt werden, ohne dass eine vollständige Visual Studio-Installation auf dem Agentcomputer erforderlich ist.

Syntax

# 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.

Eingänge

packageFeedSelector - Paketfeed-
string. Erforderlich. Zulässige Werte: nugetOrg (Offizielle Nuget), customFeed (benutzerdefinierter Feed), netShare (Netzwerkpfad). Standardwert: nugetOrg.

Gibt den Feed an, in dem die Aufgabe das NuGet-Paket der Visual Studio-Testplattform abruft.

nugetOrg - Offizielle NuGet-: Erwirbt das Testplattformpaket von NuGet. Für diese Option ist eine Internetverbindung auf dem Agentcomputer erforderlich.

customFeed - Benutzerdefinierter Feed: Erwirbt das Testplattformpaket aus einem benutzerdefinierten Feed oder einem Paketverwaltungsfeed in Azure DevOps oder TFS.

netShare - Netzwerkpfad: Installiert die Testplattform aus einer Netzwerkfreigabe. Die angegebene Microsoft.TestPlatform.nupkg Version muss von NuGet heruntergeladen und auf eine Netzwerkfreigabe platziert werden, auf die der Build-/Release-Agent zugreifen kann.

versionSelector - Version
string. Erforderlich, wenn packageFeedSelector = nugetOrg || packageFeedSelector = customFeed. Zulässige Werte: latestPreRelease (neueste Version (enthält Pre-Release)), latestStable (neueste Stable), specificVersion (bestimmte Version). Standardwert: latestPreRelease.

Installiert die neueste Version oder eine bestimmte Version der Visual Studio-Testplattform. Wenn Sie das Testplattforminstallationsprogramm verwenden, um Coded UI-Tests auszuführen, muss die ausgewählte Visual Studio-Testplattform mit der Hauptversion der Visual Studio-Installation übereinstimmen, die die Testbinärdateien erstellt hat. Wenn z. B. das Testprojekt für die codierte Benutzeroberfläche mit Visual Studio 2017 (Version 15.x) erstellt wurde, müssen Sie test platform version 15.x verwenden.

testPlatformVersion - Testplattformversion
string. Erforderlich, wenn versionSelector = specificVersion.

Gibt die Version der Visual Studio Test Platform an, die auf dem Agent installiert werden soll. Verfügbare Versionen können auf NuGet-angezeigt werden.

customFeed - Paketquelle
string. Erforderlich, wenn packageFeedSelector = customFeed.

Gibt die URL eines benutzerdefinierten Feeds oder eines Paketverwaltungsfeeds in Azure DevOps oder TFS an, die das Testplattformpaket enthält. Öffentliche und private Feeds können angegeben werden.

username - Benutzername
string. Wahlfrei. Wird verwendet, wenn packageFeedSelector = customFeed.

Gibt den Benutzernamen an, um den im Argument Paketquelle angegebenen Feed zu authentifizieren. Diese Eingabe ist nicht erforderlich, wenn die password Eingabe ein persönliches Zugriffstoken (PERSONAL Access Token, PAT) verwendet.

password - Kennwort
string. Wahlfrei. Wird verwendet, wenn packageFeedSelector = customFeed.

Gibt das Kennwort oder das persönliche Zugriffstoken (PAT) für die Authentifizierung des Feeds an, der in der customFeed Eingabe angegeben ist.

netShare - UNC-Pfad-
string. Erforderlich, wenn packageFeedSelector = netShare.

Gibt den vollständigen UNC-Pfad zur Microsoft.TestPlatform.nupkg Datei an. Die angegebene Microsoft.TestPlatform.nupkg Version muss aus NuGet- heruntergeladen und auf eine Netzwerkfreigabe platziert werden, auf die der Build-/Release-Agent zugreifen kann.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Hinweis

Wenn Sie einen gehosteten Agent verwenden, überprüfen Sie die Softwaretabelle für den Agent, den Sie verwenden, um festzustellen, ob Visual Studio installiert ist. Wenn Visual Studio installiert ist, müssen Sie die Visual Studio-Testplattform-Installationsprogrammaufgabe nicht ausführen.

Verwenden Sie diese Aufgabe, um die Microsoft-Testplattform aus nuget.org oder einem angegebenen Feed zu erwerben und sie dem Toolscache hinzuzufügen. Die Installationsprogrammaufgabe erfüllt die vstest Anforderung, und eine nachfolgende Visual Studio Test-Aufgabe in einer Build- oder Releasepipeline kann ausgeführt werden, ohne dass eine vollständige Visual Studio-Installation auf dem Agentcomputer erforderlich ist.

Hinweis

• Die aufgabe Visual Studio Test Platform Installer muss vor der Aufgabe Visual Studio Test in der Build- oder Releasepipeline angezeigt werden.
• Die Option Testplattformversion in der Aufgabe Visual Studio Test muss auf Installiert vom Tools Installerfestgelegt werden.

Siehe Ausführen von automatisierten Tests aus Testplänen.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Die Ausführung dieser Aufgabe erfüllt die folgenden Anforderungen für alle nachfolgenden Aufgaben im selben Auftrag: VsTest
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	2.144.0 oder höher
Vorgangskategorie	Werkzeug