/Gm (Minimale Neuerstellung aktivieren)

  • Artikel

Veraltet. Aktiviert die minimale Neuerstellung, die bestimmt, ob C++-Quelldateien, die geänderte C++-Klassendefinitionen enthalten (gespeichert in Headerdateien (.h)) neu kompiliert werden müssen.

Syntax

/Gm

Hinweise

/Gm ist veraltet. Es kann keinen Build für bestimmte Arten von Headerdateiänderungen auslösen. Sie können diese Option möglicherweise aus Ihren Projekten entfernen. Um die Erstellungszeiten zu verbessern, empfehlen wir, stattdessen vorkompilierte Header und inkrementelle und parallele Buildoptionen zu verwenden. Eine Liste der veralteten Compileroptionen finden Sie im Abschnitt "Veraltete und entfernte Compileroptionen " in den nach Kategorie aufgelisteten Compileroptionen.

Der Compiler speichert Abhängigkeitsinformationen zwischen Quelldateien und Klassendefinitionen während der ersten Kompilierung in der .idb-Datei des Projekts. (Abhängigkeitsinformationen teilen mit, welche Quelldatei von welcher Klassendefinition abhängt und in welcher .h-Datei sich die Definition befindet.) Nachfolgende Kompilierungen verwenden die in der .idb-Datei gespeicherten Informationen, um zu bestimmen, ob eine Quelldatei kompiliert werden muss, selbst wenn sie eine geänderte .h-Datei enthält.

Hinweis

Die minimale Neuerstellung basiert auf Klassendefinitionen, die sich zwischen Includedateien nicht ändern. Klassendefinitionen müssen für ein Projekt global sein (es sollte nur eine Definition für eine bestimmte Klasse vorhanden sein), da die Abhängigkeitsinformationen in der .idb-Datei für das gesamte Projekt erstellt werden. Wenn Sie mehr als eine Definition für eine Klasse in Ihrem Projekt haben, deaktivieren Sie die minimale Neuerstellung.

Da der inkrementelle Linker die in OBJ-Dateien enthaltenen Windows-Metadaten nicht mithilfe der Option /ZW (Windows-Runtime Kompilierung) unterstützt, ist die Option /Gm mit /ZW nicht kompatibel.

So legen Sie diese Compileroption in der Visual Studio-Entwicklungsumgebung fest

  1. Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Weitere Informationen erhalten Sie unter Set C++ compiler and build properties in Visual Studio (Festlegen der Compiler- und Buildeigenschaften (C++) in Visual Studio).

  2. Wählen Sie die Eigenschaftenseite Konfigurationseigenschaften>C/C++>Codegenerierung aus.

  3. Ändern Sie die Eigenschaft "Minimale Neuerstellung aktivieren".

So legen Sie diese Compileroption programmgesteuert fest

Siehe auch

MSVC-Compileroptionen
Syntax für die MSVC-Compilerbefehlszeile