Buildkonfigurationen

Buildkonfigurationen bieten eine Möglichkeit, mehrere Versionen von Projektmappen- und Projekteigenschaften zu speichern. Da Sie schnell auf die aktive Konfiguration zugreifen und Änderungen daran vornehmen können, ist es einfach, mehrere Konfigurationen desselben Projekts zu erstellen.

Mit Visual Studio erstellte Projekte umfassen standardmäßig eine Debug- und eine Releasekonfiguration. Debugkonfigurationen werden automatisch für das Debuggen von Anwendungen konfiguriert, während Releasekonfigurationen für die endgültige Freigabe von Anwendungen eingerichtet werden. Weitere Informationen finden Sie unter Gewusst wie: Festlegen von Debug- und Releasekonfigurationen. Sie können auch eigene benutzerdefinierte Projektmappen- und Projektkonfigurationen erstellen und bearbeiten, um sie an die Anforderungen einer Anwendung anzupassen. Weitere Informationen hierzu finden Sie unter Gewusst wie: Erstellen und Bearbeiten von Konfigurationen.

In Visual Studio können zwei Arten von Buildkonfigurationen definiert werden: Projektmappenkonfigurationen und Projektkonfigurationen.

Projektmappenkonfigurationen

Mit einer Projektmappenkonfiguration wird festgelegt, wie bestimmte Projekte in einer Projektmappe erstellt und (sofern aktiviert) bereitgestellt werden. Um eine neue Projektmappenkonfiguration zu definieren, öffnen Sie das Dialogfeld "Konfigurations-Manager" und wählen aus der Liste Konfiguration der aktuellen Projektmappe die Option Neu.

Jeder Eintrag in einer Projektmappenkonfiguration umfasst einen Projektnamen sowie Einstellungen für Konfiguration, Plattform, Erstellung und (sofern aktiviert) Bereitstellung. Die Kombination aus Projektmappenkonfiguration und Einstellungen für die Projektmappenplattform bestimmt, welche Projektkonfiguration verwendet wird. Weitere Informationen zu Projektmappenplattformen finden Sie unter Buildplattformen.

Es kann eine beliebige Anzahl von Projektmappenkonfigurationen erstellt werden, die jeweils mit einem eindeutigen Namen versehen werden. Die integrierte Entwicklungsumgebung (IDE) von Visual Studio weist automatisch Projektmappenkonfigurationen zu, wenn eine der nachstehenden Aktionen erfolgt:

  • Hinzufügen einer Projektplattform bei aktivierter Option Neue Projektmappenplattformen erstellen.

  • Hinzufügen einer Projektkonfiguration bei aktivierter Option Neue Projektmappenkonfigurationen erstellen.

  • Hinzufügen eines neuen Projekts, das auf unterschiedlichen Plattformen bereitgestellt werden soll, von denen eine neu ist.

Durch Projektmappenkonfigurationen werden in der IDE auch allgemeine Informationen zum Projektkontext bereitgestellt. Wenn in der aktiven Projektmappenkonfiguration beispielsweise angegeben ist, dass ein Projekt für ein mobiles Gerät erstellt wird, werden in der Toolbox bei der Bearbeitung dieses Projekts nur die Projektelemente angezeigt, die in einem Projekt für ein mobiles Gerät verwendet werden können.

Projektkonfigurationen

Projektkonfiguration und Projektplattform zusammen legen fest, welche Eigenschaften zum Erstellen des Projekts verwendet werden. Jede eindeutige Kombination aus Produktkonfiguration und -plattform kann über eine Gruppe definierter Projekteigenschaften verfügen. Projekteigenschaften werden mit dem Projekt-Designer bearbeitet. Bestimmte Bereiche im Projekt-Designer enthalten Dropdownlisten, in denen die aktuelle Kombination aus Projektkonfiguration und -plattform angegeben ist.

Die konfigurationsabhängigen Eigenschaften in einer Projektkonfiguration können den jeweiligen Anforderungen entsprechend definiert werden. Die Projekteigenschaften können verwendet werden, um beispielsweise festzulegen, welche Projektelemente in einem bestimmten Build eingeschlossen werden, welche Ausgabedateien erstellt werden, wo die Ausgabedateien gespeichert und wie sie optimiert werden.

Projektkonfigurationen können erhebliche Unterschiede aufweisen. So können beispielsweise die Eigenschaften der einen Projektkonfiguration eine Optimierung der Ausgabedatei festlegen, die bewirkt, dass die sich ergebende Binärdatei nur ein Minimum an Speicherplatz belegt, während ein anderes Projekt so optimiert wird, dass die zugehörige ausführbare Datei mit der maximalen Geschwindigkeit läuft.

Projektkonfigurationen werden nicht individuell vom Benutzer, sondern mit der Projektmappe gespeichert, sodass sie von einem Team gemeinsam verwendet werden können. Obwohl Projektabhängigkeiten von der Konfiguration unabhängig sind, werden nur die Projekte erstellt, die in der aktiven Projektmappenkonfiguration angegeben sind.

Ändern von Projektmappenkonfigurationen

Wenn Sie eine Projektmappe erstellen, legt Visual Studio die aktive Projektmappenkonfiguration zugrunde, in der die Projektkonfigurationen für jedes zu erstellende Projekt angegeben sind. Die aktive Konfiguration kann direkt über die Dropdownliste Projektmappenkonfigurationen auf der Standardsymbolleiste oder über das Dialogfeld "Konfigurations-Manager" geändert werden.

Tipp

Falls auf der Standardsymbolleiste keine Einstellungen für Projektmappenkonfigurationen enthalten sind oder Sie nicht auf den Konfigurations-Manager zugreifen können, sind möglicherweise Visual Basic Developer-Einstellungen aktiviert. Weitere Informationen finden Sie unter Gewusst wie: Verwalten von Buildkonfigurationen mit aktivierten Visual Basic Developer-Einstellungen.

Zuweisung der zu erstellenden Projektkonfigurationen durch die IDE

Wenn Sie eine neue Projektmappenkonfiguration erstellen (anstatt eine bereits vorhandene Konfiguration zu kopieren), legt die IDE die standardmäßigen Projektkonfigurationen für die zu erstellenden Projekte unter Verwendung der folgenden Auswahlkriterien für jedes Projekt fest (Auswertung in dieser Reihenfolge):

  1. Mit der neuen Projektmappenkonfiguration wird eine Projektkonfiguration erstellt, die denselben Namen wie die Projektmappenkonfiguration hat. In Konfigurationsnamen wird die Groß-/Kleinschreibung nicht beachtet.

  2. Wenn die Namen nicht exakt übereinstimmen, wird von der neuen Projektmappenkonfiguration eine Projektkonfiguration erstellt, deren Name den Konfigurationsnamen der Projektmappenkonfiguration enthält, unabhängig davon, ob der im Namen angegebene Plattformname ebenfalls übereinstimmt. (Beachten Sie, dass die Namenskonvention das Format <configuration name> <platform-name> aufweist.)

  3. Wenn sich immer noch keine Übereinstimmung ergibt, erstellt die neue Projektmappenkonfiguration die erste Konfiguration, die für ein Projekt aufgeführt wird.

Zuweisung von Projektmappenkonfigurationen durch die IDE

Wenn Sie eine Projektkonfiguration erstellen und Neue Projektmappenkonfigurationen erstellen aktivieren, wird in der IDE nach einer entsprechend benannten Projektmappenkonfiguration gesucht, um das Projekt für jede unterstützte Plattform zu erstellen. In einigen Fällen werden vorhandene Projektmappenkonfigurationen in der IDE umbenannt oder neue erstellt.

Von der IDE wird unter Verwendung der nachstehenden Auswahlkriterien ermittelt, wie Projektmappenkonfigurationen zugewiesen werden:

  • Wenn in einer Projektkonfiguration keine Plattform oder nur eine einzige Plattform angegeben ist, wird entweder eine Projektmappenkonfiguration gesucht, deren Name dem der neuen Projektkonfiguration entspricht, oder es wird eine solche hinzugefügt. In diesem Fall enthält der Name dieser standardmäßigen Projektmappenkonfiguration keinen Plattformnamen und weist das Format <project configuration name> auf.

  • Wenn ein Projekt mehrere Plattformen unterstützt, wird eine Projektmappenkonfiguration für jede Projektkonfiguration gesucht oder hinzugefügt, damit jedes Projekt auf den einzelnen unterstützten Plattformen erstellt werden kann. Der Name jeder Projektmappenkonfiguration umfasst sowohl den Namen der Projektkonfiguration als auch den Plattformnamen und weist das Format <project configuration name> <platform name> auf.

Siehe auch

Referenz

Dialogfeld "Konfigurations-Manager"

Devenv-Befehlszeilenschalter

Konzepte

Projekte als Container

Projekteigenschaften

Weitere Ressourcen

Der Buildprozess in Visual Studio

Referenz zur C/C++-Erstellung