VisualStudioTestPlatformInstaller@1 – Tarefa do instalador da plataforma de teste do Visual Studio v1

Use essa tarefa para adquirir a plataforma de teste da Microsoft de nuget.org ou um feed especificado e adicioná-la ao cache de ferramentas. A tarefa do instalador atende à vstest demanda e uma tarefa de teste subsequente do Visual Studio em um pipeline de build ou lançamento pode ser executada sem a necessidade de uma instalação completa do Visual Studio no computador do agente.

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

Entradas

packageFeedSelector - Feed de Pacotes
string. Obrigatórios. Valores permitidos: nugetOrg (Nuget Oficial), customFeed (Feed Personalizado) netShare (Caminho de rede). Valor padrão: nugetOrg.

Especifica o feed em que a tarefa busca o pacote NuGet da Plataforma de Teste do Visual Studio.

nugetOrg - NuGet oficial: adquire o pacote de plataforma de teste do NuGet. Essa opção requer conectividade com a Internet no computador do agente.

customFeed - Feed personalizado: adquire o pacote de plataforma de teste de um feed personalizado ou de um feed de gerenciamento de pacotes no Azure DevOps ou TFS.

netShare - Caminho de rede: instala a plataforma de teste de um compartilhamento de rede. A versão especificada Microsoft.TestPlatform.nupkg deve ser baixada do NuGet e colocada em um compartilhamento de rede que o agente de build/versão pode acessar.


versionSelector - Versão
string. Obrigatório quando packageFeedSelector = nugetOrg || packageFeedSelector = customFeed. Valores permitidos: latestPreRelease (mais recente (inclui pré-lançamento)), latestStable (estável mais recente), specificVersion (versão específica). Valor padrão: latestPreRelease.

Instala a versão mais recente ou uma versão específica da Plataforma de Teste do Visual Studio. Se você usar o instalador da plataforma de teste para executar testes de IU codificados, a Plataforma de Teste do Visual Studio escolhida deverá corresponder à versão principal da instalação do Visual Studio que criou os binários de teste. Por exemplo, se o projeto de teste de IU codificado foi criado usando o Visual Studio 2017 (versão 15.x), você deve usar a plataforma de teste versão 15.x.


testPlatformVersion - Versão da plataforma de teste
string. Obrigatório quando versionSelector = specificVersion.

Especifica a versão da Plataforma de Teste do Visual Studio a ser instalada no agente. As versões disponíveis podem ser exibidas no NuGet.


customFeed - Origem do pacote
string. Obrigatório quando packageFeedSelector = customFeed.

Especifica a URL de um feed personalizado ou um feed de gerenciamento de pacotes no Azure DevOps ou TFS que contém o pacote da plataforma de teste. Feeds públicos e privados podem ser especificados.


username - Nome de Usuário
string. Opcional. Use quando packageFeedSelector = customFeed.

Especifica o nome de usuário para autenticar o feed especificado no argumento Origem do Pacote . Essa entrada não será necessária se a password entrada usar um PAT (token de acesso pessoal).


password - Senha
string. Opcional. Use quando packageFeedSelector = customFeed.

Especifica a senha ou o PAT (token de acesso pessoal) para autenticar o feed especificado na customFeed entrada.


netShare - Caminho UNC
string. Obrigatório quando packageFeedSelector = netShare.

Especifica o caminho UNC completo para o Microsoft.TestPlatform.nupkg arquivo. A versão especificada Microsoft.TestPlatform.nupkg deve ser baixada do NuGet e colocada em um compartilhamento de rede que o agente de build/versão pode acessar.


Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

Observação

Se você estiver usando um agente hospedado, marcar a tabela de software do agente que você está usando para ver se o Visual Studio está instalado. Se o Visual Studio estiver instalado, você não precisará executar a tarefa do instalador da plataforma de teste do Visual Studio.

Use essa tarefa para adquirir a plataforma de teste da Microsoft de nuget.org ou um feed especificado e adicioná-la ao cache de ferramentas. A tarefa do instalador atende à vstest demanda e uma tarefa de teste subsequente do Visual Studio em um pipeline de build ou lançamento pode ser executada sem a necessidade de uma instalação completa do Visual Studio no computador do agente.

Observação

  • A tarefa Instalador da Plataforma de Teste do Visual Studio deve aparecer antes da tarefa Teste do Visual Studio no pipeline de build ou lançamento.
  • A opção Testar versão da plataforma na tarefa Teste do Visual Studio deve ser definida como Instalado pelo Instalador de Ferramentas.

Confira Executar testes automatizados de planos de teste.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Executa em Agent, DeploymentGroup
Demandas Nenhum
Funcionalidades A execução dessa tarefa atende às seguintes demandas para todas as tarefas subsequentes no mesmo trabalho: VsTest
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.144.0 ou superior
Categoria da tarefa Ferramenta
Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Executa em Agent, DeploymentGroup
Demandas Nenhum
Funcionalidades A execução dessa tarefa atende às seguintes demandas para todas as tarefas subsequentes no mesmo trabalho: VsTest
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.103.0 ou superior
Categoria da tarefa Ferramenta