Exécuter et déboguer des tests

Les projets de test MTP sont générés en tant qu’exécutables qui peuvent être exécutés (ou débogués) directement. Il n’existe aucune console ou commande supplémentaire exécutant des tests. L’application se termine par un code de sortie différent de zéro s’il existe une erreur, qui est typique pour la plupart des exécutables. Pour plus d’informations sur les codes de sortie connus, consultez les codes de sortie MTP.

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>

Important

Par défaut, MTP collecte les données de télémétrie. Pour plus d’informations et d’options sur la désactivation, consultez la télémétrie MTP.

Note

Disponible dans MTP à compter de la version 2.3.0.

Pour un arrêt approprié, appuyez une fois sur Ctrl+C pour demander l’annulation. L’exécution des tests peut finaliser la phase de nettoyage. Pour terminer immédiatement, appuyez de nouveau sur Ctrl+C .

.NET CLI

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.

À partir du SDK .NET 10, dotnet test dispose d’un mode MTP dédié. Sélectionnez MTP via global.json, ou utilisez la DOTNET_TEST_RUNNER variable d’environnement avec .NET 11 Preview 6 ou version ultérieure. Le mode dédié prend en charge les projets, les solutions, les modules de test générés et les types d’entrée supplémentaires dans les versions plus récentes du SDK.

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

Pour en savoir plus sur la sélection de l’exécuteur de tests et la migration depuis le mode compatible avec VSTest, consultez Tester avec dotnet test.

Visual Studio

Les tests MTP 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 projet de démarrage.

Exécuter l’application avec Visual Studio

Les projets de test MTP 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.

1. Accédez au projet de test que vous souhaitez exécuter dans Explorateur de solutions, cliquez dessus avec le bouton droit, puis sélectionnez Définir comme projet de démarrage.
2. 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

Le projet de test MTP peut être débogué directement. Pour déboguer tous les tests dans l’exécutable donné, sauf si un filtre est fourni :

1. Accédez au projet de test que vous souhaitez exécuter dans Explorateur de solutions, cliquez dessus avec le bouton droit, puis sélectionnez Définir comme projet de démarrage.
2. Définissez le point d’arrêt dans le test que vous souhaitez déboguer.
3. 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.

Visual Studio Code

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

Les projets de test MTP 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.

1. Accédez à un fichier de test pour lequel vous souhaitez exécuter des tests.
2. 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 MTP 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.

1. Accédez à un fichier de test pour lequel vous souhaitez exécuter des tests.
2. 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 construire le projet n'est pas disponible.

Intégration continue (CI)

• 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 MTP 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 MTP dans DotNetCoreCLI a été ajoutée dans la version 2.263.0 de la tâche.

Voir aussi

• Vue d’ensemble de MTP
• Informations de référence sur les options CLI MTP
• Test avec dotnet test
• dotnet test avec MTP
• Exécuter des tests avec MSTest