Expert En-tête précompilé

Remonter à Menu Outils

Outils > Expert En-tête précompilé

Remarque : Cet expert est conçu pour une utilisation avec Windows C++ 32 bits. Cet expert ne produit pas le format utilisé par Windows C++ 64 bits.

Utilisez cet expert pour créer un en-tête précompilé maître pour votre projet C++. L'expert analyse le projet, collecte les informations de fichier d'en-tête, sélectionne les en-têtes en fonction des critères définis, puis génère un fichier d'en-tête précompilé maître qui peut être utilisé pour la précompilation.

L'inclusion d'un binaire d'en-tête précompilé peut réduire de manière significative le nombre de lignes de code que le compilateur doit traiter. Théoriquement, un en-tête précompilé bien sélectionné peut également réduire de manière significative le temps requis pour compiler votre projet.

Remarque :  Les fonctionnalités décrites ici ne sont pas toutes présentes pour chaque instance de l'expert.

Page Regrouper les informations

Vous pouvez choisir la méthode à utiliser pour obtenir les informations de fichier d'en-tête : en analysant le projet ou par chargement à partir du cache basé sur les données de la précédente exécution de l'expert sur ce projet. Un troisième choix consiste à exécuter l'expert afin qu'il retire le fichier d'en-tête préalablement inclus par l'expert.

Elément	Description
Effectuer une analyse complète du projet à l'aide de la configuration de construction en cours	Demande une analyse complète du projet en utilisant la configuration de construction en cours.
Charger les informations de fichier d'en-tête depuis le cache	Spécifie que les informations du fichier d'en-tête sont à charger à partir du cache généré à la date affichée. Utilisez cette option avec précaution, car toutes les modifications effectuées sur le projet depuis que le cache a été généré ne seront pas vues.
Retirer implicitement l'en-tête précompilé inclus	Si, lors d'une exécution précédente de l'expert, vous aviez choisi que l'en-tête précompilé résultant soit automatiquement inclus durant la compilation, sélectionnez cette option pour retirer l'en-tête précompilé implicitement inclus.

Page Analyser le projet (facultatif)

Si vous avez sélectionné Effectuer une analyse complète sur la page Regrouper les informations, l'étape suivante est l'analyse du projet. L'arborescence d'inclusion est générée, rassemblée et mise en cache pour accélérer les prochaines exécutions de l'expert. Une fenêtre de message auto-documente les tâches effectuées sur cette page.

Page Critère de filtre

Vous permet de définir le critère de filtre qui contrôle le contenu de votre fichier d'en-tête précompilé maître.

Elément	Description
Inclure les en-têtes référencés par au moins ce nombre de fichiers source	Spécifie le nombre de fichiers source que doit référencer un fichier d'en-tête donné afin d'inclure le fichier d'en-tête dans l'en-tête précompilé maître.
Exclure les en-têtes sans garde (recommandé)	Omet les fichiers d'en-tête sans garde d'en-tête. Un garde d'en-tête est une construction utilisant #define pour garantir que le compilateur lit cet en-tête une SEULE FOIS durant les compilations, même s'il est référencé par beaucoup d'autres en-têtes.
Exclure les en-têtes faisant partie du projet (recommandé)	Inclut seulement les en-têtes qui sont externes au projet en cours. Cette option est recommandée car il est généralement plus probable que les en-têtes soient modifiés dans un projet en cours de développement.
Inclure/Exclure par nom de fichier	Spécifiez les fichiers que vous voulez inclure ou exclure : Inclure les fichiers correspondant à: Exclure les fichiers correspondant à: Vous pouvez utiliser les caractères génériques pour spécifier des noms de fichiers (comme *.hpp) et des noms de répertoires (comme $(BDS)/include). Pour ajouter des noms de fichiers ou de répertoires à ces champs d'entrée, utilisez les boutons situés sur le bord droit de la boîte de dialogue. Pour vous déplacer entre les listes Inclure les fichiers correspondant à et Exclure les fichiers correspondant à, utilisez les flèches directionnelles du clavier.
Restaurer les valeurs par défaut	Restaure les valeurs par défaut initiales pour toutes les options de l'expert En-tête précompilé et efface les deux champs Inclure les fichiers correspondant à et Exclure les fichiers correspondant à. Ce bouton est utile si vous avez créé un en-tête précompilé qui a causé des résultats inattendus. Si vous cherchiez un bouton Panique, c'est lui.

Page Sélectionner les fichiers

Cette page liste :

• Les fichiers en-tête qui correspondent au critère de filtre
• Les fichiers en-tête qui ne correspondent pas au critère de filtre
• Les fichiers qui peuvent être ignorés car ils sont inclus par d'autres fichiers d'en-tête

Sur cette page, vous pouvez spécifier exactement les fichiers d'en-tête qui doivent être inclus ou exclus de votre en-tête précompilé maître. Chaque fichier coché est ajouté à l'en-tête précompilé maître.

Inclus	Liste les fichiers qui correspondent au critère de filtre sélectionné sur la page précédente. Dans la liste Inclus, décochez les noms des fichiers que vous souhaitez exclure de l'en-tête maître.
Exclus	Liste les fichiers qui ne correspondent pas au critère de filtre. Dans la liste Exclus, les fichiers que vous cochez sont inclus dans l'en-tête maître.
Ignorés (implicitement inclus par d'autres en-têtes)	Liste les fichiers d'en-tête qui correspondent au critère de filtre mais seraient redondants dans l'en-tête précompilé car ils sont inclus par d'autres fichiers d'en-tête correspondants. Pour ajouter un fichier à l'en-tête précompilé, cliquez sur la case à cocher relative au fichier dans cette liste.
Exécuter un build test	Exécutez un build test en utilisant les résultats sélectionnés sur cette page. Si vous sélectionnez cette option, l'expert tente de générer le binaire de l'en-tête précompilé et de garantir ainsi qu'il est utilisable pour construire le projet.

Page Tester le build (facultatif)

Cette page apparaît seulement si vous avez sélectionné Exécuter un build test sur la page Sélectionner les fichiers. Cette page vérifie l'intégrité du fichier d'en-tête précompilé maître que l'expert générera si vous poursuivez jusqu'à la fin sans changer de critère de filtre.

Durant le build test, l'expert effectue trois étapes :

1. Il vérifie que tous les en-têtes inclus dans la page de résultats peuvent être précompilés. L'expert tente de déterminer quels en-têtes sont problématiques, et il les retire.
2. Il recherche les en-têtes qui contiennent des données initialisées et il retire les en-têtes du fichier d'en-tête précompilé maître. Les en-têtes contenant des données initialisées feront échouer la création du fichier PCH.
3. Il exécute le build test et le compilateur. Tous les fichiers qui ne sont pas construits sont marqués afin de ne pas utiliser le fichier d'en-tête précompilé maître (auto pch).

champ message	Le build test est en mode auto-documentation et il affiche ses propres messages informationnels, ainsi que les erreurs du compilateur.
Boutons Arrêter/Redémarrer/Suivant	Le build test démarre automatiquement, mais le bouton Arrêter est immédiatement disponible. Lorsque le build test s'achève, le bouton Arrêter devient le bouton Redémarrer. Vous devez cliquer sur le bouton Suivant pour avancer sur la page finale de l'expert.

Nom de fichier et paramètres

C'est la page finale de l'expert En-tête précompilé.

Inclusion implicite pour toutes les unités de compilation	Spécifie que l'expert doit effectuer l'inclusion PCH automatique. L'expert configurera le projet afin d'utiliser automatiquement l'en-tête précompilé maître pour tous les fichiers source. Définit les options BCC32 -Hi et -Hh sur "Injecter le fichier d'en-tête précompilé".
Générer seulement le fichier, je vais l'inclure explicitement.	Spécifie que l'expert va seulement créer le fichier d'en-tête précompilé maître. Vous devez ajouter une commande #include (située devant #pragma hdrstop) dans chaque fichier source indiquant que vous voulez utiliser le fichier d'en-tête précompilé maître.
Fichier de sortie	Spécifie l'emplacement et le nom du fichier d'en-tête précompilé maître. Le nom de fichier par défaut est pch<n>.h.
Ouvrir dans l'éditeur	Crée le fichier d'en-tête précompilé maître et l'ouvre dans l'éditeur de code.

Voir aussi

• Présentation des en-têtes précompilés
• Options de ligne de commande des en-têtes précompilés pour BCC32
• BCC32.EXE, le compilateur C++ 32 bits en ligne de commande
• Compilateurs C++ améliorés par Clang, Support des en-têtes précompilés
• Utilisation des en-têtes précompilés avec les compilateurs C++ améliorés par Clang