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.
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.
Os testes MTP podem ser executados (e depurados) no Visual Studio, integram-se com o Test Explorer e também podem ser executados diretamente como projeto de arranque.
Executa a aplicação com o Visual Studio
Os projetos de teste MTP são construídos como executáveis e podem ser executados diretamente. Isso executa todos os testes no executável fornecido, a menos que um filtro seja fornecido.
- Navegue até ao projeto de teste que pretende executar no Explorador de Soluções, selecione-o com o botão direito do rato e selecione Definir como Projeto de Inicialização.
- Selecione Debug>Iniciar sem Depuração (ou use Ctrl+F5) para executar o projeto de teste selecionado.
A janela do console é exibida, mostrando a execução e o resumo do seu teste.
Depure a aplicação diretamente no Visual Studio
O projeto de teste MTP pode ser debugado diretamente. Para depurar todos os testes no executável fornecido, a não ser que um filtro seja fornecido:
- Navegue até ao projeto de teste que pretende executar no Explorador de Soluções, selecione-o com o botão direito do rato e selecione Definir como Projeto de Inicialização.
- Defina o ponto de interrupção no teste que você gostaria de depurar.
- Vá a Debug>Iniciar Depuração (ou pressione F5) para depurar o projeto de teste selecionado.
Todos os testes são executados até que o teste que possui um ponto de interrupção seja atingido. Passe pelo teste para depurá-lo. Quando terminares de depurar, a aplicação continuará a executar todos os testes restantes, a menos que a interrompas.
Usar o Explorador de Testes
Para executar um teste, navegue até Gerenciador de Testes, selecione o teste (ou testes) a ser executado. Selecione-o com o botão direito do mouse e escolha Executar. Da mesma forma que para depurar um teste, selecione o teste (ou testes) no Gerenciador de Testes, selecione com o botão direito do mouse e escolha Depurar.
Observação
A atualização automática dos testes sem compilar o projeto não está disponível.
A extensão C# juntamente com C# Dev Kit permite depurar/executar testes em código Visual Studio, além de adicionar integração com o Explorador de Testes da Visual Studio Code.
Executa a aplicação com o Visual Studio Code
Os projetos de teste MTP são construídos como executáveis e podem ser executados diretamente. Isso executa todos os testes no executável fornecido, a menos que um filtro seja fornecido.
- Navegue até um arquivo de teste para o qual você deseja executar testes.
- Use Ctrl+F5 para executar o projeto de teste selecionado. Se você tiver vários projetos, um pop-up solicitará que você selecione o que será executado.
A janela do console é exibida, mostrando a execução e o resumo do seu teste.
Depure a aplicação diretamente no Visual Studio Code
Os projetos de teste MTP são construídos como executáveis e podem ser executados diretamente. Isso executa todos os testes no executável fornecido, a menos que um filtro seja fornecido.
- Navegue até um arquivo de teste para o qual você deseja executar testes.
- Use F5 para depurar o projeto de teste selecionado. Se você tiver vários projetos, um pop-up solicitará que você selecione o que será executado.
Sugestão
Existem várias outras formas de executar um project dotnet usando C# DevKit, como correr a partir do solution explorer ou criar configurações de lançamento correspondentes. Estas são especificadas na documentação do Código Visual Studio.
Quando o projeto é executado, aparece o separador de saída com a execução e o resumo da sua execução de teste.
Usar o Explorador de Testes
Para executar um teste, navegue até Gerenciador de Testes, selecione o teste (ou testes) a ser executado. Selecione-o com o botão direito do mouse e escolha Executar. Da mesma forma que para depurar um teste, selecione o teste (ou testes) no Gerenciador de Testes, selecione com o botão direito do mouse e escolha Depurar.
Observação
A atualização automática dos testes sem compilar o projeto não está disponível.
Para executar múltiplos projetos de teste em paralelo, invoque dotnet test uma vez para a solução em vez de adicionar um passo de pipeline para cada executável de teste. Quando adicionas um projeto de teste MTP à solução, o mesmo comando inclui-o sem alterar o pipeline.
Run a solution in Azure Pipelines
Utilize o SDK .NET 10 ou posterior e o MTP 1.7 ou posterior. Todos os projetos de teste na solução devem suportar MTP; Projetos de teste apenas VSTest não são suportados neste modo. Para versões anteriores do SDK, veja Executar projetos MTP com o modo VSTest.
Na raiz do repositório, crie um global.json ficheiro com o conteúdo seguinte. Se o ficheiro já existir, adicione a test secção e certifique-se de que as definições do SDK selecionam .NET 10 ou posterior.
{
"test": {
"runner": "Microsoft.Testing.Platform"
}
}
Para os relatórios TRX, cada projeto de teste deve referenciar Microsoft.Testing.Extensions.TrxReport, diretamente ou através de uma configuração ou perfil do SDK de teste que o inclua. Para mais detalhes, consulte os relatórios de teste do Visual Studio (TRX).
Adicione o ficheiro seguinte azure-pipelines.yml ao seu repositório. O exemplo assume que Contoso.sln e global.json estão na raiz do repositório. Substitua Contoso.sln pelo caminho relativo ao repositório da sua solução.
trigger:
- main
pool:
vmImage: ubuntu-latest
steps:
- task: UseDotNet@2
displayName: Install .NET SDK
inputs:
packageType: sdk
version: 10.0.x
- task: DotNetCoreCLI@2
displayName: Run solution tests
inputs:
command: test
projects: Contoso.sln
arguments: --configuration Release --max-parallel-test-modules 4
workingDirectory: $(Build.SourcesDirectory)
publishTestResults: true
A DotNetCoreCLI@2 tarefa invoca dotnet test uma vez para a solução. O comando restaura dependências, constrói a solução e executa os seus módulos de teste MTP em paralelo. Por defeito, dotnet test corre até Environment.ProcessorCount módulos ao mesmo tempo. O exemplo utiliza --max-parallel-test-modules 4 para limitar a concorrência a quatro módulos. Ajusta o limite para corresponder ao CPU, memória e outros recursos do teu agente.
Importante
Selecione um ficheiro de solução em projects, não um padrão de ficheiro de projeto como **/*.csproj. A tarefa invoca dotnet test separadamente para cada ficheiro emparelhado, um após o outro. Uma única invocação da solução permite dotnet test coordenar a execução paralela entre os seus projetos de teste.
O paralelismo ao nível do módulo é separado da execução paralela de testes dentro de um módulo. Para configurar testes paralelos dentro de um assembly, use as definições do seu framework de teste. Para MSTest, veja ParallelizeAttribute.
Com publishTestResults: true, a tarefa adiciona --report-trx e --results-directory publica os relatórios no separador Testes da execução do pipeline, mesmo que os testes falhem. Um código de saída não nulo dotnet test também faz falhar a tarefa e o pipeline.
Observação
O suporte a MTP em DotNetCoreCLI@2 requer a versão 2.263.0 da tarefa ou posterior. Mantém global.json no diretório de trabalho da tarefa para que tanto a tarefa como o SDK .NET selecionem MTP.
Executar uma solução com um script
Para versões de tarefas sem suporte MTP, ou para controlar diretamente o comando CLI, use um script e publique os relatórios TRX numa etapa separada. Aplicam-se os mesmos requisitos para o SDK .NET, global.json e a extensão TRX.
trigger:
- main
pool:
vmImage: ubuntu-latest
steps:
- task: UseDotNet@2
displayName: Install .NET SDK
inputs:
packageType: sdk
version: 10.0.x
- task: CmdLine@2
displayName: Run solution tests
inputs:
script: >-
dotnet test --solution Contoso.sln
--configuration Release
--max-parallel-test-modules 4
--results-directory "$(Agent.TempDirectory)"
--report-trx
workingDirectory: $(Build.SourcesDirectory)
- task: PublishTestResults@2
displayName: Publish test results
condition: succeededOrFailed()
inputs:
testResultsFormat: VSTest
testResultsFiles: '**/*.trx'
searchFolder: $(Agent.TempDirectory)
failTaskOnFailedTests: true
failTaskOnMissingResultsFile: true
A succeededOrFailed() condicional publica os resultados após um teste bem-sucedido ou falhado. O código de saída não nulo do script continua a falhar o pipeline. Para evitar a substituição de relatórios entre módulos, não atribua o mesmo nome de ficheiro TRX a todos os módulos. Para opções de nomeação e isolamento, consulte Nomes de ficheiros de relatório.
Executar um único executável de teste
Para um único projeto de teste, construa ou publique o projeto antes de invocar diretamente o seu executável:
- task: CmdLine@2
displayName: "Run Contoso.MyTests"
inputs:
script: '.\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'