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.

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

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`

O MTP oferece uma camada de compatibilidade com vstest.console.exe e dotnet test, garantindo que possa executar os seus testes como antes, enquanto permite novos cenários de execução.

dotnet test Contoso.MyTests.dll

Para executar um único project de teste em CI, adicione um passo para cada executável de teste que pretende executar, como o seguinte no Azure DevOps:
```
- task: CmdLine@2
  displayName: "Run Contoso.MyTests"
  inputs:
    script: '.\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'
```

Execute o dotnet test comando manualmente, semelhante ao fluxo de trabalho local típico:

- task: CmdLine@2
  displayName: "Run tests"
  inputs:
    script: 'dotnet test' # add command-line options as needed

Execute usando a tarefa DotNetCoreCLI Azure com o comando test. Isto requer um global.json ficheiro na raiz do teu repositório que especifique o MTP como executor de teste:
```
{
    "test": {
        "runner": "Microsoft.Testing.Platform"
    }
}
```
```
- task: DotNetCoreCLI@2
  displayName: "Run tests"
  inputs:
    command: test
```
Observação

A versão 2.263.0 da tarefa adicionou suporte para MTP em DotNetCoreCLI.

Consulte também

Comentários

Esta página foi útil?

Last updated on 2026-04-27

Utilize `dotnet run`

Utilize `dotnet exec`

Utilize `dotnet test`

Executa a aplicação com o Visual Studio

Depure a aplicação diretamente no Visual Studio

Usar o Explorador de Testes

Executa a aplicação com o Visual Studio Code

Depure a aplicação diretamente no Visual Studio Code

Usar o Explorador de Testes

Executar e depurar testes

Utilize dotnet run

Utilize dotnet exec

Utilize dotnet test

Consulte também

Comentários

Recursos adicionais

Utilize `dotnet run`

Utilize `dotnet exec`

Utilize `dotnet test`