Compartilhar via


Usando VSTest.Console na linha de comando

Execute qualquer unidade ou testes de IU da linha de comando com VSTest.Console.exe codificados. Ele é otimizado para desempenho e é usado no lugar de MSTest.exe na Visual Studio 2012 ou versões posteriores.

Especifica várias opções em qualquer ordem na linha de comando VSTest.Console.exe. Essas opções são listadas na tabela de opções gerais de linha de comando a seguir.

vstest.console.exe interpreta esses valores e opções que você especifica em um modo sem diferenciação de maiúsculas e minúsculas.

A tabela a seguir lista todas as opções para VSTest.Console.exe e breves descrições sobre elas. É possível ver um resumo semelhante digitando VSTest.Console /? na linha de comando. VSTest.Console.exe está localizado aqui: C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\TestWindow.

Dica

O adaptador MSTest no Visual Studio 2012 também funciona no modo herdado (equivalente à execução de testes com mstest.exe) para compatibilidade.No modo herdado, não é possível aproveitar os novos recursos do VS11 TestCaseFilter.O adaptador pode alternar para modo herdado quando o arquivo .testsettings é especificado, forcelegacymode é definido para true no arquivo .runsettings ou usando atributos como HostType.

Dica

Para executar testes automatizados em um computador baseado na arquitetura ARM, use o VSTest.Console.exe.

Opções gerais de linha de comando

/Settings:[nome de arquivo]

Execute testes com configurações adicionais, como coletores de dados.

Exemplo: /Settings:Local.RunSettings

/Tests:[nome do teste]

Execute testes com nomes que correspondam aos valores fornecidos.

Para fornecer vários valores, separe-os por vírgulas.

Exemplo: /Tests:TestMethod1,testMethod2

Aviso

A opção de linha de comando /Tests não pode ser usada com a opção de linha de comando /TestCaseFilter.

/Enablecodecoverage

Permite o adaptador de diagnóstico de dados CodeCoverage na execução de teste.

As configurações padrão serão usadas se não forem especificadas usando o arquivo de configurações.

/InIsolation

Executa os testes em um processo isolado.

Isso torna o processo vstest.console.exe menos suscetível a ser interrompido por engano nos testes. Entretanto, os testes podem ser executados de forma mais lenta.

/UseVsixExtensions

Isso faz com que o processo vstest.console.exe use ou ignore as extensões VSIX instaladas (se houver) na execução de teste.

Exemplo: /UseVsixExtensions:true

/Platform:[tipo de plataforma]

Arquitetura da plataforma de destino a ser usada para a execução de teste.

Os valores válidos são x86, x64 e ARM.

/Framework: [versão do Framework]

Versão do .NET Framework de destino a ser usada na execução de teste.

Os valores válidos são Framework35, Framework40 e Framework45.

Exemplo: /Framework:framework40

/TestCaseFilter:[expressão]

Execute testes que correspondam à expressão fornecida.

< expression > está no formato < propriedade > = < valor > [| < Expression >].

Exemplo: /TestCaseFilter:"Priority=1"

Exemplo: /TestCaseFilter:"TestCategory=Nightly|FullyQualifiedName=Namespace.ClassName.MethodName"

Aviso

A opção de linha de comando /TestCaseFilter não pode ser usada com a opção de linha de comando /Tests.

/Logger:[URI/friendlyname]

Especificar um agente para resultados do teste.

Exemplo: para registrar os resultados em um arquivo de resultados do teste do Visual Studio (TRX), use /Logger:trx.

Exemplo: para publicar resultados do teste no Team Foundation Server, use TfsPublisher:

/logger:TfsPublisher;

Collection=<team project url>;

BuildName=<build name>;

TeamProject=<team project name>;

[;Platform=<Defaults to “Any CPU”>]

[;Flavor=<Defaults to “Debug”>]

[;RunTitle=<title>]

Dica

O agente TfsPublisher exige o Visual Studio 2012 com [Visual Studio 2012.1] ou posterior.

/ListTests:[nome de arquivo]

Lista testes descobertos do contêiner de teste fornecido.

/ListDiscoverers

Lista detectores de testes instalados.

/ListExecutors

Lista executores de testes instalados.

/ListLoggers

Lista agentes de testes instalados.

/ListSettingsProviders

Lista provedores de configurações de teste instalados.

Usando VSTest.Console.exe com arquivos de teste

A sintaxe de vstest.console.exe é:

Vstest.console.exe [TestFileNames] [Options]

Veja a seguir um exemplo de como usar VSTest.Console.exe da linha de comando:

Vstest.console.exe myTestProject.dll

Veja a seguir um exemplo de como usar VSTest.Console.exe da linha de comando usando vários arquivos de teste. Isso é feito separando nomes de arquivos de teste por espaços:

Vstest.console.exe myTestFile.dll myOtherTestFile.dll

Exemplo

O exemplo a seguir mostra o uso de algumas das opções para a execução de Vstest.console.exe. Nesse caso, o comando executará os testes no arquivo myTestFile.dll, enquanto coleta dados especificados no arquivo Local.RunSettings e em um processo isolado. Além disso, o comando filtrará os casos de teste a serem executados com base em "Prioridade 1" e registrará os resultados em um arquivo .trx.

vstest.console.exe  myTestFile.dll /Settings:Local.RunSettings /InIsolation /TestCaseFilter:"Priority=1" /Logger:trx

Consulte também

Conceitos

Executando testes automatizados a partir da linha de comando

Compatibilidade de configurações de testes com o Visual Studio 2010

Outros recursos

Atualizando testes a partir de versões anteriores do Visual Studio