Übersicht über Optionsgruppen
Nach oben zu Compilieren, Build erstellen und Anwendungen ausführen - Index
C++Builder und Delphi unterstützen die Verwendung von Optionsgruppendateien zur Verwaltung von Build-Konfigurationen. Beide Personalities unterstützen auch die Möglichkeit, eine Optionsgruppe per Referenz für eine Build-Konfiguration anzuwenden, wie in diesem Thema beschrieben.
Optionsgruppen sind Festplattendateien mit den Werten, die Sie für Build-bezogene Projektoptionen festgelegt haben. Optionsgruppen werden in Dateien mit der Erweiterung .optset in Ihrem Projektordner gespeichert. Sie können eine Optionsgruppe auf die aktuelle Build-Konfiguration per Referenz oder per Wert anwenden.
Inhaltsverzeichnis
Erstellen und Bearbeiten von Optionsgruppen
Sie können eine Optionsgruppe mithilfe des Kontextmenübefehls Neue Optionsgruppe von Build-Konfigurationen (oder Build-Konfigurations-Element) in der Projektverwaltung anlegen. Dieser Befehl erstellt eine neue, leere Optionsgruppe und fügt sie Ihrem Projekt hinzu. Verwenden Sie zum Bearbeiten einer Optionsgruppe den Kontextmenübefehl Bearbeiten der Projektverwaltung. Das Dialogfeld Projektoptionen wird geöffnet, in dem Sie die Werte für die Optionen der Optionsgruppe überprüfen und anpassen können.
Optionsgruppen und Build-Konfigurationen im Vergleich
Sowohl Optionsgruppen als auch Build-Konfigurationen bestehen aus einer Reihe von Optionswerten, die auf die MSBuild-Projektdatei bezogen sind. Der Hauptunterschied besteht darin, dass Build-Konfigurationen in der Projektdatei gespeichert werden, während Optionsgruppen in .optset -XML-Dateien unabhängig vom Projekt gespeichert werden.
Beim Speichern und Erzeugen eines Projekts werden Änderungen der Build-Konfigurationen gespeichert, Optionsgruppen jedoch werden separat (über die Schaltfläche Speichern auf den Seiten Projekt > Optionen) gespeichert. Das Ändern der Konfigurationen eines Projekts und das Hinzufügen oder Löschen von Konfigurationen wirkt sich nicht auf die Optionsgruppen aus. Genauso verändert das Speichern von Optionsgruppen die Konfigurationen nicht.
Optionsgruppen können auf Build-Konfigurationen entweder per Referenz oder per Wert angewendet werden. Jedes Projekt verfügt, unabhängig von anderen Projekten, über eine eigene Liste der Build-Konfigurationen sowie über eine Liste der Optionsgruppen, die Sie per Referenz hinzugefügt haben. Optionsgruppen, die per Wert hinzugefügt wurden, haben keine dauernde Auswirkung auf das Projekt. Sie können auf alle Optionsgruppendateien aus allen Projekten zugreifen.
Optionswerte in Build-Konfigurationen und Optionsgruppen
Konfigurationen und Optionsgruppen müssen nicht für alle möglichen Projektoptionen Werte enthalten. Wenn Sie eine Optionsgruppe speichern, werden nur die Werte gespeichert, die sich von den Werten der übergeordneten Konfiguration unterscheiden, nicht die Werte für alle Optionen.
Angenommen, Sie haben ein Projekt in der IDE geöffnet, und die aktive Konfiguration ist Debug. Sie ändern eine Option und speichern die Optionsgruppe. Die einzigen Optionswerte, die in der Optionsgruppendatei gespeichert werden, sind der eine geänderte Optionswert plus alle Optionswerte in der Debug-Konfiguration, die sich von den Vorgabewerten unterscheiden (Vorgabewerte werden im Dialogfeld Projekt > Optionen in Fettschrift angezeigt).
Eine Optionsgruppe übernehmen
Optionsgruppenwerte (eine .optset-Datei) lassen sich auf jede beliebige Konfiguration eines jeden Projekts mithilfe des Dialogfeldes Optionsgruppe anwenden (wird mit der Schaltfläche Laden im Dialogfeld Projekt > Optionengeöffnet) anwenden.
Folgendermaßen können Sie eine Optionsgruppe anwenden:
- Als Referenz hinzufügen: Die Optionswerte in der Konfiguration werden jedes Mal aktualisiert, wenn sich der Wert der übergeordneten Option in der Optionsgruppendatei ändert.
- Die Konfiguration ändern: Die Optionswerte in der Konfiguration werden nur einmal geändert und beziehen sich nicht auf die übergeordnete Optionsgruppe.
Anwenden einer Optionsgruppe als Referenz
Wenn Sie im Dialogfeld Optionsgruppe anwenden die Option Als Referenz hinzufügen wählen, werden die Werte in der Optionsgruppe der aktuellen Konfiguration hinzugefügt, und sie ersetzen nur diese Werte. Auf Optionen, für die kein bestimmter Wert in der Optionsgruppe festgelegt wurde, hat das keine Auswirkungen.
Wenn Sie die Optionsgruppe später ändern, wird die Änderung auch für alle Werte der Konfiguration vorgenommen, die von dieser Optionsgruppe abgeleitet wurden. Diese dauernde Verbindung zwischen einer Optionsgruppe und einer Build-Konfiguration wird eingerichtet, wenn Sie die Optionsgruppe als Referenz anwenden. In der Projektverwaltung wird eine Optionsgruppe, die per Referenz hinzugefügt wurde, unter dem Knoten der zugehörigen Build-Konfiguration aufgeführt. Sie müssen Projektänderungen speichern, um die Referenz auf die Optionsgruppe in dem Projekt zu speichern.
Eigenschaften in Optionsgruppen werden in der Reihenfolge übernommen, in der die Optionsgruppen in der Projektverwaltung aufgeführt sind. Das bedeutet für Eigenschaften, die in mehreren Optionsgruppen enthalten sind, dass die letzte Optionsgruppe in der Liste den Wert aus der vorherigen Optionsgruppe überschreibt usw. Sie können Optionsgruppen, die per Referenz aufgeführt sind, per Drag&Drop neu anordnen.
Ändern einer Build-Konfiguration durch Anwenden einer Optionsgruppe per Wert
Wenn Sie im Dialogfeld Optionsgruppe anwenden die Option Diese Konfiguration ändern wählen, werden die Werte in der Optionsgruppe für die aktuelle Build-Konfiguration angewendet (die Konfiguration, die im Feld Build-Konfiguration des Dialogfeldes Projekt > Optionen angezeigt wird).
Die Werte werden nur einmal übernommen, und es besteht keine weitere Verbindung zwischen der Konfiguration und der Optionsgruppe. Wenn Sie die Optionsgruppe später ändern, wirkt sich das nicht auf die Build-Konfiguration aus.
Die Optionsgruppenwerte werden für die aktuelle Build-Konfiguration entsprechend der Priorität, die Sie ausgewählt haben, folgendermaßen angewendet:
- Alle Werte ersetzen ergibt eine Build-Konfiguration, die eine genaue Kopie der Optionsgruppe ist.
- Optionsgruppendatei fügt der Build-Konfiguration die Werte der Optionsgruppe hinzu, ändert aber keine anderen Optionswerte in der Konfiguration.
- Diese Konfiguration behält die Werte in der aktuellen Build-Konfiguration bei und fügt nur diejenigen Werte aus der Optionsgruppe hinzu, für die in der Build-Konfiguration keine Werte vorhanden sind.