Conseil / Astuce
Vous pouvez ignorer un code de sortie spécifique à l’aide de l’option de ligne de commande --ignore-exit-code.
Vous pouvez également définir des options de ligne de commande qui s’appliquent à un project de test spécifique dans le fichier project à l’aide de la propriété MSBuild TestingPlatformCommandLineArguments. Un cas d’usage courant est destiné aux projets de test qui ont tous les tests ignorés, qui se terminent normalement avec le code de sortie 8 (la session de test a exécuté zéro test). Dans ce scénario, vous pouvez ajouter ce qui suit sous un PropertyGroup dans votre fichier project :
<TestingPlatformCommandLineArguments>$(TestingPlatformCommandLineArguments) --ignore-exit-code 8</TestingPlatformCommandLineArguments>
La publication du project de test à l’aide de dotnet publish et l’exécution directe de l’application est un autre moyen d’exécuter vos tests. Par exemple, l’exécution du ./Contoso.MyTests.exe. Dans certains scénarios, il est également viable d’utiliser dotnet build pour produire l’exécutable, mais il peut y avoir des cas de périphérie à prendre en compte, comme AOT natif.
Utilisez dotnet run.
La commande dotnet run peut être utilisée pour générer et exécuter votre project de test. C’est le plus simple, bien que parfois lent, moyen d’exécuter vos tests. L'utilisation de dotnet run est pratique lorsque vous modifiez et exécutez des tests localement, car cela garantit que le project de test est reconstruit lorsque nécessaire.
dotnet run trouve également automatiquement le projet dans le répertoire actuel.
dotnet run --project Contoso.MyTests
Pour plus d’informations sur dotnet run, consultez dotnet run.
Utilisez dotnet exec.
La commande dotnet exec ou dotnet est utilisée pour exécuter (ou exécuter) un project de test déjà généré, il s’agit d’une alternative à l’exécution directe de l’application.
dotnet exec nécessite le chemin d'accès vers la dll du projet de test généré.
dotnet exec Contoso.MyTests.dll
ou
dotnet Contoso.MyTests.dll
Note
Fournir le chemin d’accès au fichier exécutable du projet de test (*.exe) entraîne une erreur :
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'
Pour plus d’informations sur dotnet exec, consultez dotnet exec.
Utilisez dotnet test.
Microsoft.Testing.Platform offre une couche de compatibilité avec vstest.console.exe et dotnet test, vous assurant que vous pouvez exécuter vos tests comme avant tout en activant un nouveau scénario d’exécution.
dotnet test Contoso.MyTests.dll
Les tests Microsoft.Testing.Platform peuvent être exécutés (et débogués) dans Visual Studio, ils s’intègrent à l’Explorateur de tests et peuvent également être exécutés directement en tant que project de démarrage.
Exécuter l’application avec Visual Studio
Microsoft.Testing.Platform Les projets de test sont générés en tant qu'exécutables et peuvent être exécutés directement. Cela exécute tous les tests dans l’exécutable donné, sauf si un filtre est fourni.
- Accédez au projet de test que vous souhaitez exécuter dans Solution Explorer, cliquez dessus avec le bouton droit, puis sélectionnez Définir comme projet de démarrage.
- Sélectionnez Debug>Démarrer sans débogage (ou utilisez Ctrl+F5) pour exécuter le projet de test sélectionné.
Une fenêtre de console s’affiche avec l’exécution et le résumé de votre série de tests.
Déboguer l’application directement dans Visual Studio
Microsoft.Testing.Platform projet de test peut être débogué directement. Pour déboguer tous les tests dans l’exécutable donné, sauf si un filtre est fourni :
- Accédez au projet de test que vous souhaitez exécuter dans Solution Explorer, sélectionnez-le avec le bouton droit, puis sélectionnez Définir comme projet de démarrage.
- Définissez le point d’arrêt dans le test que vous souhaitez déboguer.
- Accédez à Debug>Démarrer le débogage (ou appuyez sur F5) pour déboguer le projet de test sélectionné.
Tous les tests sont exécutés jusqu’à ce que votre test avec un point d’arrêt soit atteint. Parcourez votre test pour le déboguer. Une fois le débogage terminé, l’application reprend l’exécution de tous les tests restants, sauf si vous l’arrêtez.
Utiliser l’Explorateur de tests
Pour exécuter un test, accédez à Test Explorer, sélectionnez le test (ou les tests) à exécuter. Sélectionnez-le avec le bouton droit, puis choisissez Exécuter. Comme pour déboguer un test, sélectionnez le test (ou les tests) dans Test Explorer, sélectionnez avec le bouton droit et choisissez Déboguer.
Note
La mise à jour automatique des tests sans construire le projet n'est pas disponible.
L'extension C# avec C# Dev Kit vous permet de déboguer/exécuter des tests dans Visual Studio code, ainsi que d'ajouter l'intégration à l'Explorateur de tests de Visual Studio Code.
Exécuter l’application avec Visual Studio Code
Microsoft.Testing.Platform projets de test sont générés en tant qu'exécutables et peuvent être exécutés directement. Cela exécute tous les tests dans l’exécutable donné, sauf si un filtre est fourni.
- Accédez à un fichier de test pour lequel vous souhaitez exécuter des tests.
- Utilisez Ctrl+F5 pour exécuter le project de test sélectionné. Si vous avez plusieurs projets, une fenêtre contextuelle vous demande de sélectionner celle à exécuter.
Une fenêtre de console s’affiche avec l’exécution et le résumé de votre série de tests.
Déboguer l’application directement dans Visual Studio Code
Les projets de test sont générés en tant qu'exécutables et peuvent être exécutés directement. Cela exécute tous les tests dans l’exécutable donné, sauf si un filtre est fourni.
- Accédez à un fichier de test pour lequel vous souhaitez exécuter des tests.
- Utilisez F5 pour déboguer le project de test sélectionné. Si vous avez plusieurs projets, une fenêtre contextuelle vous demande de sélectionner celle à exécuter.
Conseil / Astuce
Il existe plusieurs autres façons d’exécuter un project dotnet à l’aide du DevKit C#, comme l’exécution à partir de solution explorer ou la création de configurations de lancement correspondantes. Elles sont spécifiées dans la documentation Visual Studio Code.
Lorsque le projet est exécuté, un onglet de sortie s’affiche avec l’exécution et le résumé de votre test.
Utiliser l’Explorateur de tests
Pour exécuter un test, accédez à Test Explorer, sélectionnez le test (ou les tests) à exécuter. Sélectionnez-le avec le bouton droit, puis choisissez Exécuter. Comme pour déboguer un test, sélectionnez le test (ou les tests) dans Test Explorer, sélectionnez avec le bouton droit et choisissez Déboguer.
Note
La mise à jour automatique des tests sans compiler le projet n'est pas disponible.
Pour exécuter un seul projet de test dans un environnement CI, ajoutez une étape pour chaque fichier exécutable de test que vous souhaitez faire fonctionner, par exemple sur Azure DevOps :
- task: CmdLine@2
displayName: "Run Contoso.MyTests"
inputs:
script: '.\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'
Exécutez la dotnet test commande manuellement, similaire au flux de travail local classique :
- task: CmdLine@2
displayName: "Run tests"
inputs:
script: 'dotnet test' # add command-line options as needed
Exécutez en utilisant la tâche DotNetCoreCLI Azure avec la commande de test. Cela nécessite un global.json fichier dans la racine de votre référentiel qui spécifie Microsoft.Testing.Platform comme exécuteur de test :
{
"test": {
"runner": "Microsoft.Testing.Platform"
}
}
- task: DotNetCoreCLI@2
displayName: "Run tests"
inputs:
command: test
Note
La prise en charge de Microsoft.Testing.Platform dans DotNetCoreCLI a été ajoutée dans la version 2.263.0 de la tâche.