/Gm (Activer la régénération minimale)

  • Article

Action déconseillée. Permet une régénération minimale, qui détermine si les fichiers sources C++ qui incluent des définitions de classe C++ modifiées (stockées dans des fichiers d'en-tête (.h)) doivent être recompilés.

Syntaxe

/Gm

Notes

/Gm est déconseillé. Il peut ne pas déclencher une build pour certains types de modifications de fichier d’en-tête. Vous pouvez supprimer cette option de vos projets en toute sécurité. Pour améliorer les temps de génération, nous vous recommandons d’utiliser des en-têtes précompilés et des options de génération incrémentielles et parallèles à la place. Pour obtenir la liste des options de compilateur déconseillées, consultez la section Options du compilateur déconseillées et supprimées dans options du compilateur listées par catégorie.

Le compilateur stocke des informations sur les dépendances entre les fichiers sources et les définitions de classe dans le fichier .idb du projet au cours de la première compilation. (Les informations sur les dépendances indiquent quel fichier source est dépendant de quelle définition de classe, et dans quel fichier .h la définition se trouve.) Les compilations suivantes utilisent les informations stockées dans le fichier .idb pour déterminer si un fichier source a besoin d'être compilé, même s'il inclut un fichier .h modifié.

Remarque

Une régénération minimale s'appuie sur des définitions de classe qui ne changent pas entre les fichiers Include. Les définitions de classe doivent être globales pour un projet (il doit exister une seule définition d'une classe donnée), car les informations sur les dépendances dans le fichier .idb sont créées pour le projet entier. Si vous possédez plusieurs définitions pour une classe dans votre projet, désactivez la régénération minimale.

Étant donné que l’éditeur de liens incrémentiel ne prend pas en charge les métadonnées Windows incluses dans les fichiers .obj à l’aide de l’option /ZW (compilation Windows Runtime), l’option /Gm n’est pas compatible avec /ZW.

Pour définir cette option du compilateur dans l'environnement de développement Visual Studio

  1. Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d’informations, consultez Définir le compilateur C++ et les propriétés de build dans Visual Studio.

  2. Sélectionnez la page de propriétés De configuration>C/C++>Génération de code.

  3. Modifiez la propriété Enable Minimal Rebuild .

Pour définir cette option du compilateur par programmation

Voir aussi

Options du compilateur MSVC
Syntaxe de la ligne de commande du compilateur MSVC