Extensão VSTest Bridge
Esta extensão fornece uma camada de compatibilidade com o VSTest permitindo que as estruturas de teste que dependem dele continuem a suportar a execução no modo VSTest (vstest.console.exe, usual dotnet test, VSTest task no AzDo, Test Explorers of Visual Studio e Visual Studio Code...). Esta extensão é fornecida como parte do pacote Microsoft.Testing.Extensions.VSTestBridge .
Compatibilidade com VSTest
O principal objetivo desta extensão é oferecer uma experiência de atualização fácil e suave para os usuários VSTest, permitindo um modo duplo onde a nova plataforma é habilitada e, em paralelo, um modo de compatibilidade é oferecido para permitir que os fluxos de trabalho habituais continuem funcionando.
Suporte a Runsettings
Esta extensão permite que você forneça um arquivo .runsettings VSTest, mas nem todas as opções neste arquivo são captadas pela plataforma. Descrevemos abaixo as configurações, opções de configuração e alternativas suportadas e não suportadas para as opções de configuração VSTest mais usadas.
Quando habilitado pela estrutura de teste, você pode usar --settings <SETTINGS_FILE> para fornecer o .runsettings arquivo.
Elemento RunConfiguration
O elemento RunConfiguration pode incluir os seguintes elementos. Nenhuma destas definições é respeitada por Microsoft.Testing.Platform:
| Nó | Description | Justificação / Solução alternativa |
|---|---|---|
| MaxCpuCount | Essa configuração controla o nível de paralelismo no nível do processo. Use 0 para habilitar o paralelismo máximo no nível do processo. | Quando Microsoft.Testing.Platform é usado com MSBuild, essa opção é descarregada para MSBuild. Quando um único executável é executado, essa opção não tem significado para Microsoft.Testing.Platform. |
| Diretório de Resultados | O diretório onde os resultados do teste são colocados. O caminho é relativo ao diretório que contém o arquivo .runsettings . | Use a opção --results-directory de linha de comando para determinar o diretório onde os resultados do teste serão colocados. Se o diretório especificado não existir, ele será criado. O padrão está TestResults no diretório que contém o aplicativo de teste. |
| TargetFrameworkVersion | Essa configuração define a versão da estrutura ou a família de estruturas a ser usada para executar testes. | Esta opção é ignorada. As <TargetFramework> propriedades ou <TargetFrameworks> MSBuild determinam a estrutura de destino do aplicativo. Os testes são alojados na candidatura final. |
| Plataforma Alvo | Essa configuração define a arquitetura a ser usada para executar testes. | <RuntimeIdentifier> Determina a arquitetura do aplicativo final que hospeda os testes. |
| TreatTestAdapterErrorsAsWarnings | Suprime erros do adaptador de teste para se tornarem avisos. | Microsoft.Testing.Platform permite que apenas um tipo de testes seja executado a partir de um único assembly, e a falha ao carregar a estrutura de teste ou outras partes da infraestrutura se tornará um erro não pulável, porque significa que alguns testes não puderam ser descobertos ou executados. |
| TestAdaptersPaths | Um ou mais caminhos para o diretório onde os TestAdapters estão localizados | Microsoft.Testing.Platform não usa o conceito de adaptadores de teste e não permite o carregamento dinâmico de extensões, a menos que elas façam parte da compilação e sejam registradas no Program.cs, automaticamente por meio de destinos de compilação ou manualmente. |
| TestCaseFilter | Um filtro para limitar os testes que serão executados. | Para filtrar testes, use --filter a opção de linha de comando. |
| TestSessionTimeout | Permite que os usuários encerrem uma sessão de teste quando ela exceder um determinado tempo limite. | Não há outra opção. |
| DotnetHostPath | Especifique um caminho personalizado para o host dotnet que é usado para executar o host de teste. | Microsoft.Testing.Platform não está fazendo nenhuma resolução adicional de dotnet. Depende totalmente de como o dotnet se resolve, o que pode ser controlado por variáveis de ambiente como DOTNET_HOST_PATH. |
| TreatNoTestsAsError | Saia com código de saída diferente de zero quando nenhum teste for descoberto. | Microsoft.Testing.Platform errará por padrão quando nenhum teste for descoberto ou executado em um aplicativo de teste. Você pode definir quantos testes espera encontrar no assembly usando --minimum-expected-tests o parâmetro de linha de comando, cujo padrão é 1. |
Elemento DataCollectors
Microsoft.Testing.Platform não está usando coletores de dados. Em vez disso, tem o conceito de extensões dentro e fora do processo. Cada extensão é configurada pelo seu respetivo arquivo de configuração ou através da linha de comando.
Mais importante ainda , a extensão de travamento e falha e a extensão de cobertura de código.
Elemento LoggerRunSettings
Os registradores em Microsoft.Testing.Platform são configurados por meio de parâmetros de linha de comando ou por configurações no código.
Suporte ao filtro VSTest
Esta extensão também oferece a capacidade de usar o mecanismo de filtragem VSTest para descobrir ou executar apenas os testes que correspondem à expressão de filtro. Para obter mais informações, consulte a seção Detalhes da opção Filtro ou, para obter detalhes específicos da estrutura, consulte a página Executando testes de unidade seletiva.
Quando habilitado pela estrutura de teste, você pode usar --filter <FILTER_EXPRESSION>o .
