Applications C++ existantes de tests unitaires avec Test Explorer
Nous vous recommandons, avant de modifier une application existante, de vérifier qu'elle a une bonne couverture de tests unitaires.Vous êtes ainsi sûr que vos modifications n'ont pas introduit de bogues.Si l'application n'a pas encore de tests unitaires, vous pouvez les ajouter à l'aide des techniques expliquées dans cette rubrique.Cette rubrique décrit comment ajouter des tests unitaires pour du code Visual C++ existant, en commençant par choisir comment tester votre code, puis en créant, écrivant et enfin exécutant les tests.
Décider comment tester votre code
Ouvrez le projet C++ existant, et examinez-le pour déterminer comment ajouter les tests unitaires.Vous pouvez utiliser des outils de modélisation, qui vous permettent d'afficher les dépendances du code et vous aident à comprendre comment les parties interagissent.Pour plus d'informations, consultez Visualiser du code.
Nous vous recommandons de répartir vos modifications en petites tâches.Avant chaque petite modification, écrivez des tests unitaires pour les aspects du comportement qui resteront identiques.Lorsque vous avez effectué la modification, ces tests continuent de réussir.Par exemple, si vous envisagez de modifier une fonction de tri pour qu'elle trie une liste de personnes par le nom au lieu du prénom, vous pouvez écrire un test unitaire qui vérifie que tous les noms d'entrée apparaissent dans la sortie.Après avoir apporté la modification, vous pouvez ajouter de nouveaux tests unitaires pour le nouveau comportement.
S'il est pratique, une grande partie ou la totalité de vos tests unitaires doivent utiliser uniquement les fonctions qui sont exportées.Toutefois, si vous modifiez simplement une petite partie de l'application, vous pouvez utiliser les fonctions qui ne sont pas exportées.Par exemple, vous pouvez avoir besoin de tests qui appellent des fonctions internes ou qui définissent et obtiennent les valeurs des variables internes.
Il existe plusieurs façons de tester le code du produit, selon qu'il expose les interfaces que vous souhaitez tester.Choisissez l'un des moyens suivants :
- Les tests unitaires utilisent uniquement les fonctions exportées à partir du code testé :
Ajoutez un projet de test distinct.Dans ce projet de test, ajoutez une référence au projet testé.
Passez à la procédure Pour référencer les fonctions exportées à partir du projet de test.
Le code testé est généré sous forme d'un fichier .exe :
Ajoutez un projet de test distinct.Liez-le au fichier objet de sortie.Passez à la procédure Pour lier les tests aux fichiers objets ou bibliothèques.
Les tests unitaires doivent utiliser des données et des fonctions privées, et le code testé peut être établi comme bibliothèque statique :
Modifiez le projet testé pour qu'il soit compilé en un fichier .lib.Ajoutez un projet de test distinct qui référence le projet testé.Cette approche présente l'avantage de permettre à vos tests d'utiliser des membres privés mais de conserver les tests dans un projet distinct.Toutefois, elle peut ne pas convenir pour certaines applications où vous devez avoir une bibliothèque de liens dynamiques (.dll).
Passez à la procédure Pour changer le code testé en une bibliothèque statique.
Les tests unitaires doivent utiliser des données et des fonctions privées, et le code doit être généré sous forme d'une bibliothèque de liens dynamiques (DLL) :
Ajoutez les tests unitaires dans le même projet que le code du produit.Passez à la procédure Pour ajouter des tests unitaires dans le même projet.
Créer les tests
Pour changer le code testé en une bibliothèque statique
Si vos tests doivent utiliser des membres qui ne sont pas exportés par un projet testé et que le projet de test est généré sous forme d'une bibliothèque dynamique, pensez à le convertir en bibliothèque statique.
Dans l'Explorateur de solutions, dans le menu contextuel du projet testé, choisissez Propriétés.La fenêtre des propriétés du projet s'ouvre.
Choisissez Propriétés de configuration, Général.
Définissez Type de configuration sur Bibliothèque statique (.lib).
Poursuivez avec la procédure Pour lier les tests aux fichiers objets ou bibliothèques.
Pour référencer des fonctions exportées depuis le projet de test
Si un projet testé exporte les fonctions que vous souhaitez tester, vous pouvez ajouter une référence au projet de code à partir du projet de test.
Créez un projet de test C++.
- Dans le menu Fichier, choisissez Nouveau, Projet, Visual C++,Test, Projet de test unitaire C++.
Dans l'Explorateur de solutions, dans le menu contextuel du projet de test, choisissez Références.La fenêtre des propriétés du projet s'ouvre.
Sélectionnez Propriétés communes, Structure et références, puis choisissez le bouton Ajouter une nouvelle référence.
Sélectionnez Projets, puis le projet à tester.
Choisissez le bouton Ajouter.
Dans les propriétés du projet de test, ajoutez l'emplacement du projet testé aux répertoires Include.
Choisissez Propriétés de configuration, Répertoires VC++, Répertoires Include.
Choisissez Modifier, puis ajoutez le répertoire d'en-tête du projet testé.
Passez à Écrire les tests unitaires.
Pour lier les tests aux fichiers objets ou bibliothèques
Si le code testé n'exporte pas les fonctions que vous souhaitez tester, vous pouvez ajouter le fichier de sortie .obj ou .lib aux dépendances du projet de test.
Créez un projet de test C++.
- Dans le menu Fichier, choisissez Nouveau, Projet, Visual C++,Test, Projet de test unitaire C++.
Dans l'Explorateur de solutions, dans le menu contextuel du projet de test, choisissez Propriétés.La fenêtre des propriétés du projet s'ouvre.
Choisissez Propriétés de configuration, Éditeur de liens, Entrée, Dépendances supplémentaires.
Choisissez Modifier, puis ajoutez les noms des fichiers .obj ou .lib.N'utilisez pas les chemins d'accès complets.
Choisissez Propriétés de configuration, Éditeur de liens, Général, Répertoires de bibliothèques supplémentaires.
Choisissez Modifier, puis ajoutez le chemin d'accès au répertoire des fichiers .obj ou .lib.Le chemin d'accès se trouve généralement dans le dossier de build du projet testé.
Choisissez Propriétés de configuration, Répertoires VC++, Répertoires Include.
Choisissez Modifier, puis ajoutez le répertoire d'en-tête du projet testé.
Passez à Écrire les tests unitaires.
Pour ajouter des tests unitaires dans le même projet
Modifiez les propriétés du projet du code du produit pour inclure les en-têtes et les fichiers bibliothèques qui sont requis pour le test unitaire.
Dans l'Explorateur de solutions, dans le menu contextuel du projet testé, choisissez Propriétés.La fenêtre des propriétés du projet s'ouvre.
Choisissez Propriétés de configuration, Répertoires VC++.
Modifiez les répertoires Include et de bibliothèques :
Répertoires Include
$(VCInstallDir)UnitTest\include;$(IncludePath)
Répertoires de bibliothèques
$(VCInstallDir)UnitTest\lib;$(LibraryPath)
Ajoutez un fichier de test unitaire C++ :
- Dans l'Explorateur de solutions, dans le menu contextuel du projet, choisissez Ajouter, Nouvel élément, puis Test unitaire C++.
Passez à Écrire les tests unitaires.
Écrire les tests unitaires
Dans chaque fichier de code de test unitaire, ajoutez une instruction #include pour les en-têtes du projet testé.
Ajoutez les classes et les méthodes de test aux fichiers de code de test unitaire.Par exemple :
#include "stdafx.h" #include "CppUnitTest.h" #include "MyProjectUnderTest.h" using namespace Microsoft::VisualStudio::CppUnitTestFramework; namespace MyTest { TEST_CLASS(MyTests) { public: TEST_METHOD(MyTestMethod) { Assert::AreEqual(MyProject::Multiply(2,3), 6); } }; }
Pour plus d'informations, consultez Tests unitaires du code natif avec Test Explorer.
Exécuter les tests
Dans le menu Affichage, choisissez Autres fenêtres, Explorateur de tests.
Dans l'Explorateur de tests, choisissez Exécuter tout.
Pour plus d'informations, consultez Démarrage rapide : développement piloté avec Test Explorer.