Choix du dossier d'instrumentation
Mise à jour : novembre 2007
Si vous devez rassembler les données de couverture du code pendant le test de code dans un fichier binaire, Visual Studio doit d'abord instrumenter ce fichier binaire. Le processus d'instrumentation ajoute le code au fichier binaire qui génère les données de couverture du code. Pour plus d'informations sur l'instrumentation des fichiers binaires pour la couverture du code, consultez Comment : obtenir des données de couverture du code.
Vous pouvez contrôler certains aspects du processus d'instrumentation, notamment l'emplacement où l'instrumentation est effectuée. Visual Studio peut instrumenter des fichiers binaires de deux manières :
Sur place. Si vous choisissez l'instrumentation sur place, Visual Studio instrumente le fichier binaire dans le dossier où il réside avant l'exécution du test. Si le fichier binaire fait partie d'une application que vous êtes en train de créer, il s'agit du dossier où Visual Studio a généré le fichier binaire.
Dans le dossier de déploiement. Si vous ne choisissez pas l'instrumentation sur place, Visual Studio instrumente le fichier binaire dans le dossier de déploiement. Les dossiers de déploiement sont créés spécifiquement pour les séries de tests. Pour plus d'informations sur le processus de déploiement, consultez Vue d'ensemble du déploiement de test.
Pour choisir le dossier à utiliser, consultez Choix du dossier d'instrumentation. Pour plus d'informations sur la configuration du dossier, consultez Spécification du dossier d'instrumentation.
Choix du dossier d'instrumentation
Comment déterminer le dossier le plus approprié pour l'instrumentation du fichier binaire ? Le choix du dossier de déploiement dépend du niveau d'accès au fichier binaire dont vous bénéficiez et du type de fichier binaire.
Fichiers binaires avec disponibilité limitée. Tout fichier binaire qui possède un ou plusieurs des états suivants est signalé dans le tableau suivant comme fichier binaire à disponibilité limitée :
Le fichier binaire est partagé entre plusieurs personnes. Le problème qui se pose avec les fichiers binaires partagés est le risque de conflit en cas d'utilisation simultanée par plusieurs utilisateurs. Exemple : deux utilisateurs démarrent des séries de tests et demandent des données de couverture du code dans le même fichier binaire en même temps.
Le fichier binaire ne se trouve pas sur l'ordinateur local, mais sur un partage réseau.
Vous avez accès en lecture seule au fichier binaire.
Fichiers binaires avec emplacement de chargement fixe. Le moteur d'exécution de tests peut charger certains fichiers binaires uniquement à partir d'un emplacement spécifique. Un tel fichier binaire est appelé dans le tableau suivant fichier binaire avec emplacement de chargement fixe. Ces fichiers comprennent les types de fichiers suivants :
des composants COM ;
Pages du Panneau de configuration
Le tableau suivant offre une aide au choix du dossier d'instrumentation correct. Consultez la colonne Remarques supplémentaire pour les cas qui nécessitent la prise en compte de facteurs spéciaux.
Charger l'emplacement du fichier binaire |
Disponibilité du fichier binaire |
Instrumenter dans ce dossier |
Remarques supplémentaires |
fixed |
non limité |
sur place |
(aucun) |
non fixe |
limité |
dans le dossier de déploiement |
(aucun) |
non fixe |
non limité |
Les deux dossiers fonctionnent, mais il est recommandé de choisir 'dans le dossier de déploiement'. |
Si après avoir choisi l'instrumentation sur place, vous régénérez un fichier binaire instrumenté pendant la série de tests, le moteur de test détecte que le fichier binaire régénéré est plus récent. Il ne restaure pas sa version pré-instrumentée et émet un avertissement de niveau d'exécution. |
fixed |
limité |
sur place, mais consultez les remarques supplémentaires |
Si vous ne choisissez pas l'instrumentation sur place, aucun fichier binaire situé dans un emplacement fixe n'est instrumenté. Cela signifie que, même si l'exécution de test réussit et qu'aucun avertissement de niveau d'exécution ne soit généré, les données de couverture du code ne sont pas rassemblées. Pour des suggestions de solution de contournement, consultez Emplacement fixe, fichiers binaires à disponibilité limitée. |
Spécification du dossier d'instrumentation
Vous pouvez choisir entre l'instrumentation sur place et l'instrumentation dans le dossier de déploiement de deux manières :
Pour faire de votre choix le paramètre par défaut, ouvrez la boîte de dialogue Options dans le menu Outils de Visual Studio. Vous trouverez ce paramètre sur la page Exécution de tests sous le nœud Outils de test.
Vous pouvez également spécifier le dossier d'instrumentation pour une configuration de série de tests particulière. Sur la page Couverture du code de l'éditeur de configuration de série de tests, vous pouvez cocher Instrumenter les assemblys sur place. Pour plus d'informations, consultez Comment : spécifier la configuration d'une série de tests.
Emplacement fixe, fichiers binaires à disponibilité limitée
Le moteur de test doit être capable de modifier le fichier binaire à instrumenter sur place. Pour rendre cela possible, vérifiez les critères suivants :
L'attribut de lecture seule du fichier binaire ne doit pas être défini. Vous pouvez modifier ce paramètre si vous bénéficiez des autorisations suffisantes sur le fichier.
Le moteur de test doit bénéficier des autorisations requises pour l'instrumentation du fichier binaire. Cela signifie que l'utilisateur qui exécute le test doit bénéficier des privilèges requis pour modifier les fichiers binaires. Parce que l'instrumentation est exécutée par l'application hôte, le compte qui a besoin de ces privilèges est le compte sous lequel devenv.exe ou MSTest.exe est exécuté, que l'exécution s'effectue localement ou à distance. Ce compte appartient à la personne qui exécute Visual Studio, qui a exécuté la commande MSTest.exe ou qui a démarré une build qui, à son tour, exécute des tests.
Le fichier binaire ne doit pas être en cours d'utilisation ou verrouillé par un autre programme. Pour corriger ce problème, vous devez arrêter le programme qui provoque le verrouillage ou attendre qu'il finisse.
Si le moteur de test ne peut toujours pas instrumenter un ou plusieurs fichiers binaires, il génère un avertissement de niveau d'exécution.
Voir aussi
Tâches
Comment : spécifier la configuration d'une série de tests
Comment : configurer le déploiement d'un test
Concepts
Instrumentation et nouvelle signature d'assemblys
Vue d'ensemble du déploiement de test