Affichage des résultats de couverture de code

Vous pouvez afficher les résultats de couverture de code dans un rapport de plan de travail ou HTML, ou dans l'éditeur. Par défaut, ce sont des rapports de plan de travail qui sont générés.

Pourquoi et quand exécuter cette tâche

Cette tâche explique comment vous pouvez afficher vos données de couverture de code à partir de rapports de plan de travail, de rapports HTML ou de l'éditeur.

Utilisation des rapports de plan de travail

Pourquoi et quand exécuter cette tâche

Dans les rapports de plan de travail, vous pouvez trier les colonnes pour vous aider à identifier rapidement les niveaux de couverture non acceptables. Vous pouvez trier les données de couverture de code par élément, couverture, lignes couvertes ou total des lignes comme suit :
  • En cliquant sur l'en-tête de colonne dans le rapport. Le fait de cliquer sur l'en-tête fera passer l'ordre de tri de croissant à décroissant.
  • En utilisant le menu déroulant Trier par Menu déroulant Trier par.

    Rapport de plan de travail

Vous pouvez aussi utiliser l'icône d'élément Icône d'élément pour filtrer les éléments signalés. L'icône sert de commande de bascule et peut être utilisée pour montrer tous les éléments du rapport ou seulement ceux qui ne satisfont pas aux critères d'acceptation. Notez que chaque élément ne satisfaisant pas aux critères apparaît dans le rapport avec un "x" rouge en surimpression. Par exemple, le rapport suivant filtre le rapport ci-dessus de façon à ne montrer que les éléments qui ne satisfont pas aux seuils d'acceptation. Notez que les résultats de couverture de code pour payroll.cpp ne sont plus présents :

Rapport filtré de plan de travail

Enfin, depuis le rapport de plan de travail, vous pouvez ouvrir la source dans l'éditeur en double-cliquant sur l'unité de compilation (telle qu'un fichier source ou une fonction) ou bien en cliquant avec le bouton droit sur l'unité de compilation puis en cliquant sur Ouvrir dans l'éditeur.

Utilisation des rapports HTML

Pourquoi et quand exécuter cette tâche

Dans les rapports HTML, vous pouvez trier les colonnes pour vous aider à identifier rapidement les niveaux de couverture non acceptables. Vous pouvez trier les données de couverture de code par lignes couvertes, total des lignes ou pourcentage de couverture. Le fait de cliquer sur l'en-tête de colonne dans le rapport fera passer l'ordre de tri de croissant à décroissant.

Pour voir les résultats détaillés de la couverture de code pour un module, une unité de compilation ou un fichier source spécifique, cliquez sur cet élément. Par exemple, le fait de cliquer sur le fichier source payroll.cpp dans le rapport suivant affiche les détails de sa couverture de code :

Rapport HTMLUtilisez la barre des éléments de navigation pour revenir à un rapport de plus haut niveau. Par exemple, cliquez sur Overall Summary (Récapitulatif général) dans cette barre de chemin de navigation "Barre de chemin de navigation" pour revenir au récapitulatif général.

Remarque : La source ne peut pas être ouverte dans l'éditeur depuis un rapport HTML. Cette possibilité est prise en charge seulement depuis un rapport de plan de travail.

Affiche de rapports de couverture de code dans un éditeur distant

Pourquoi et quand exécuter cette tâche

Pour ouvrir le code source et afficher ses résultats de couverture de code dans l'éditeur, depuis le rapport de couverture de code de plan de travail, double-cliquez sur l'unité de compilation (telle qu'un fichier source ou une fonction), ou bien cliquez avec le bouton droit sur l'unité de compilation puis cliquez sur Ouvrir dans l'éditeur. (Cette possibilité n'est pas prise en charge dans les rapports HTML.) La source s'ouvrira dans l'éditeur avec des éléments graphiques montrant la couverture de code pour chaque ligne. Par défaut, une barre verte à côté de la ligne indique que la ligne a été couverte et une barre rouge indique que la ligne n'a pas été couverte. Placez votre pointeur sur l'indicateur pour voir les détails spécifiques de la couverture, comme illustré ici :

Mise en évidence dans l'éditeur

Accès au code couvert ou non couvert dans la source

Pourquoi et quand exécuter cette tâche

Dans l'éditeur, vous pouvez accéder à la ligne suivante du code source qui a un niveau de couverture spécifié en utilisant le menu déroulant du bouton de la barre d'outils Accéder à l'élément suivant dans une liste :

Code non couvert

Par défaut, les options Code couvert et Code non couvert sont sélectionnées. (Notez que Code partiellement couvert n'est pas pris en charge pour la couverture de code des langages compilés.)

Pour changer les critères de couverture, cochez ou décochez les différents éléments pour définir la liste des critères souhaités à utiliser pour la navigation. Par exemple, pour passer de ligne non couverte en ligne non couverte dans le code source, sélectionnez Code non couvert comme illustré ci-dessus. Cliquez sur le bouton de la barre d'outils Accéder à l'élément suivant dans une liste pour passer à la ligne non couverte suivante dans le code source.

Notez que si Code couvert et Code non couvert sont tous deux sélectionnés, le fait de cliquer sur le bouton de la barre d'outils vous fera passer à la ligne suivante de la source qui satisfait à l'une ou l'autre de ces conditions spécifiées.

Activation des éléments graphiques de couverture de code dans la source

Pourquoi et quand exécuter cette tâche

Par défaut, des indicateurs de couverture de code sont affichés dans l'éditeur. Vous pouvez supprimer les indicateurs de couverture de code de l'éditeur, mais la couverture de code reste activée pour le lancement sélectionné du programme. Pour désactiver les indicateurs de couverture de code, cliquez avez le bouton droit sur la colonne de règle de l'éditeur et décochez l'option Afficher la couverture des lignes. Vous pouvez aussi cocher l'option Afficher la couverture des lignes à un moment ultérieur pour activer à nouveau les indicateurs de couverture de code.


Commentaires en retour