Executar e depurar testes

Os projetos de teste MTP são construídos como executáveis que podem ser executados (ou depurados) diretamente. Não há nenhum console ou comando de execução de teste extra. O aplicativo sai com um código de saída diferente de zero se houver um erro, o que é típico para a maioria dos executáveis. Para mais informações sobre os códigos de saída conhecidos, consulte códigos de saída MTP.

Sugestão

Você pode ignorar um código de saída de específico usando a opção de linha de comando --ignore-exit-code.

Também pode definir opções de linha de comando que se aplicam a um projeto de teste específico no ficheiro de projeto usando a propriedade TestingPlatformCommandLineArguments MSBuild. Um caso de uso comum é para projetos de teste que têm todos os testes ignorados, que normalmente sairão com o código de saída 8 (a sessão de teste executou zero testes). Neste cenário, pode adicionar o seguinte debaixo de um PropertyGroup no seu ficheiro de projeto:

<TestingPlatformCommandLineArguments>$(TestingPlatformCommandLineArguments) --ignore-exit-code 8</TestingPlatformCommandLineArguments>

Importante

Por defeito, o MTP recolhe telemetria. Para mais informações e opções sobre como optar por não participar, veja telemetria MTP.

Observação

Disponível em MTP a partir da versão 2.3.0.

Para uma paragem elegante, pressione Ctrl+C uma vez para pedir o cancelamento. Fazer testes pode terminar a demolição. Para terminar imediatamente, pressione Ctrl+C novamente.

Publicar o projeto de teste usando dotnet publish e executar a aplicação diretamente é outra forma de executar os testes. Por exemplo, executar o ./Contoso.MyTests.exe. Em alguns cenários, também é viável usar dotnet build para produzir o executável, mas podem haver casos especiais a considerar; por exemplo, AOT Nativo.

Utilize dotnet run

O comando dotnet run pode ser usado para compilar e executar o seu projeto de teste. Esta é a maneira mais fácil, embora às vezes mais lenta, de executar seus testes. Usar dotnet run é prático quando edita e executa testes localmente, porque garante que o projeto de teste é reconstruído quando necessário. dotnet run também encontrará automaticamente o projeto na pasta atual.

dotnet run --project Contoso.MyTests

Para obter mais informações sobre dotnet run, veja dotnet run.

Utilize dotnet exec

O comando dotnet exec ou dotnet é usado para executar (ou rodar) um projeto de teste já construído, sendo esta uma alternativa à execução direta da aplicação. dotnet exec requer o caminho para o DLL do projeto de teste construído.

dotnet exec Contoso.MyTests.dll

ou

dotnet Contoso.MyTests.dll

Observação

Fornecer o caminho para o executável do projeto de teste (*.exe) resulta num erro:

Error:
  An assembly specified in the application dependencies manifest
  (Contoso.MyTests.deps.json) has already been found but with a different
  file extension:
    package: 'Contoso.MyTests', version: '1.0.0'
    path: 'Contoso.MyTests.dll'
    previously found assembly: 'S:\t\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'

Para obter mais informações sobre dotnet exec, consulte dotnet exec.

Utilize dotnet test

A partir do SDK .NET 10, dotnet test tem um modo MTP dedicado. Selecione MTP através de global.json, ou utilize a variável de ambiente DOTNET_TEST_RUNNER com o .NET 11 Preview 6 ou posterior. O modo dedicado suporta projetos, soluções, módulos de teste construídos e tipos de entrada adicionais em versões mais recentes do SDK.

dotnet test --test-modules Contoso.MyTests.dll

Para obter informações sobre a seleção e a migração de runners a partir do modo compatível com VSTest, consulte Testar com dotnet test.

Consulte também

  • Última atualização a