Définition des niveaux d'acceptation de la couverture de code

Vous pouvez spécifier des niveaux d'acceptation de la couverture de code pour un ou plusieurs des éléments suivants : module, unité de compilation, fichier source ou fonction. Tous les critères doivent être remplis pour que le programme soit indiqué comme satisfaisant aux exigences de couverture de code.

Pourquoi et quand exécuter cette tâche

Lorsque vous définissez des niveaux de couverture de code, le niveau que vous entrez est le pourcentage minimal acceptable de couverture de code. Vous pouvez définir des niveaux de couverture de code acceptables pour un ou plusieurs des éléments suivants :
  • Couverture de module
  • Couverture d'unité de compilation
  • Couverture de fichier source
  • Couverture de fonction
Par défaut, un lancement de couverture de code utilise un seuil de module de 80% comme seul critère d'acceptation.
Avertissement : Avant de changer les critères de seuil pour vos lancements de couverture de code, sachez que toutes les informations d'état de réussite et d'échec seront perdues pour les lancements précédents qui ont été générés avant la session de plan de travail en cours (c'est-à-dire que si vous arrêtez l'environnement de développement intégré et que vous le redémarrez, vous devez générer à nouveau le rapport avant de redéfinir les critères de seuil si vous voulez que le nouveau statut du seuil soit automatiquement appliqué au lancement précédent). Pour plus d'informations, voir Utilisation de la vue Historique des lancements de couverture de code compilé.

Procédure

Pour personnaliser les niveaux ou les seuils d'acceptation de couverture de code :
  1. Sélectionnez Fenêtre > Préférences.
  2. Sélectionnez Exécuter/Déboguer > Débogage compilé > Couverture de code.
  3. Spécifiez le pourcentage minimal acceptable de couverture de code pour un ou plusieurs des éléments suivants :
    • Couverture de module : le pourcentage de lignes qui doivent être couvertes dans le module pour satisfaire aux critères d'acceptation.
    • Couverture d'unité de compilation : le pourcentage de lignes qui doivent être couvertes dans l'unité de compilation pour satisfaire aux critères d'acceptation.
    • Couverture de fichier source : le pourcentage de lignes qui doivent être couvertes dans le fichier source pour satisfaire aux critères d'acceptation.
    • Couverture de fonction : le pourcentage de lignes qui doivent être couvertes dans la fonction pour satisfaire aux critères d'acceptation.
    Utilisez les cases à cocher pour sélectionner les éléments souhaités. Entrez les pourcentages de couverture de code minimale acceptable dans la zone associée pour chaque élément sélectionné.

  4. Cliquez sur le bouton OK.
  5. Pour restaurer les critères d'acceptation par défaut pour un lancement de couverture de code, ouvrez les pages des préférences de couverture de code et cliquez sur le bouton Restaurer les valeurs par défaut. Le niveau du seuil pour les modules sera réinitialisé à 80% et tous les autres niveaux de seuil seront désélectionnés.

Notez que tous les critères doivent être remplis pour que le programme soit indiqué comme satisfaisant aux exigences de couverture de code. Une icône apparaîtra dans l'Historique des lancements de couverture de code compilé, indiquant si les critères d'acceptation ont été satisfaits ou non. En outre, chaque élément ne satisfaisant pas aux critères apparaît dans le rapport avec un "x" rouge en surimpression. Par exemple, l'utilisation de la préférence définie ci-dessus (un niveau d'acceptation de fichier source à 44 %) a abouti au rapport de couverture de code suivant pour le programme payroll. Notez qu'un "x" rouge apparaît en surimpression à côté de payfunc.hpp car la couverture de code de 19 % est inférieure au critère d'acceptation de 44 %.


Commentaires