Gewusst wie: Organisieren von Projektausgabedateien für Builds
In diesem Thema werden empfohlene Vorgehensweisen zum Organisieren von Projektausgabedateien beschrieben. Wenn Projektausgabedateien falsch eingerichtet werden, können Buildfehler auftreten. Außerdem werden in diesem Thema die Vor- und Nachteile der einzelnen Möglichkeiten zum Organisieren von Projektausgabedateien erörtert.
Verweisen auf CLR-Assemblys
So verweisen Sie mit #using auf Assemblys
Mit der #using-Direktive können Sie direkt aus dem Code auf Assemblys verweisen (Beispiel: #using <System.Data.dll>). Weitere Informationen finden Sie unter #using Directive (C/C++).
Die angegebene Datei kann eine DLL-, EXE-, NETMODULE oder OBJ-Datei sein, solange sie sich in MSIL befindet. Die Komponente, auf die verwiesen wird, kann in einer beliebigen Sprache erstellt sein. Mit dieser Option erhalten Sie Zugriff auf Intellisense, da die Metadaten aus MSIL extrahiert werden. Die fragliche Datei muss sich im Pfad für das Projekt befinden, ansonsten wird das Projekt nicht kompiliert, und Intellisense ist nicht verfügbar. Um auf einfache Weise festzustellen, ob die Datei sich im Pfad befindet, klicken Sie mit der rechten Maustaste auf die #using-Zeile, und wählen Sie den Befehl Dokument öffnen aus. Wenn die Datei nicht gefunden werden kann, erhalten Sie eine Benachrichtigung.
Wenn Sie nicht den vollständigen Pfad zur Datei eingeben möchten, können Sie mit der /AI-Compileroption den Suchpfad für #using-Verweise bearbeiten. Weitere Informationen finden Sie unter /AI (Metadatenverzeichnisse festlegen).
So verweisen Sie mit /FU auf Assemblys
Anstatt in der oben beschriebenen Weise direkt aus einer Codedatei auf eine Assembly zu verweisen, können Sie auch die /FU-Compileroption verwenden. Der Vorteil dieses Verfahrens besteht darin, dass Sie nicht jeder einzelnen Datei eine separate, auf eine bestimmte Assembly verweisende #using-Anweisung hinzufügen müssen.
Um diese Option festzulegen, öffnen Sie die Eigenschaftenseiten für das Projekt. Erweitern Sie den Knoten Konfigurationseigenschaften und anschließend den Knoten C/C++, und wählen Sie Erweitert aus. Fügen Sie neben #using erzwingen die gewünschten Assemblys hinzu. Weitere Informationen finden Sie unter /FU (Name der expliziten #using-Datei).
So verweisen Sie mit "Neuen Verweis hinzufügen" auf Assemblys
Dies ist die einfachste Möglichkeit zur Nutzung von CLR-Assemblys. Vergewissern Sie sich zunächst, dass das Projekt mit der /clr-Compileroption kompiliert wird. Klicken Sie anschließend im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und wählen Sie Verweise aus. Das Dialogfeld Eigenschaftenseiten wird angezeigt.
Wählen Sie im Dialogfeld Eigenschaftenseiten die Option Neuen Verweis hinzufügen aus. Daraufhin wird ein Dialogfeld angezeigt, in dem alle im aktuellen Projekt verfügbaren .NET-Assemblys, COM-Assemblys und sonstigen Assemblys aufgelistet werden. Wählen Sie die gewünschte Assembly aus, und klicken Sie auf OK.
Sobald ein Projektverweis festgelegt ist, werden die entsprechenden Abhängigkeiten automatisch behandelt. Da eine Assembly Metadaten enthält, ist es auch nicht erforderlich, den Elementen, die von verwalteten Assemblys verwendet werden, eine Headerdatei oder einen Prototyp hinzuzufügen.
Verweisen auf systemeigene DLLs oder statische Bibliotheken
So verweisen Sie auf systemeigene DLLs oder statische Bibliotheken
Verweisen Sie mit der #include-Direktive auf die entsprechende Headerdatei im Code. Die Headerdatei muss sich im include-Pfad befinden oder dem aktuellen Projekt angehören. Weitere Informationen finden Sie unter #include Directive (C/C++).
Sie können auch Projektabhängigkeiten festlegen. Das Festlegen von Projektabhängigkeiten garantiert zwei Dinge: Zum einen gewährleistet es, dass Projekte in der richtigen Reihenfolge erstellt werden, damit ein Projekt immer die benötigten abhängigen Dateien findet. Zum anderen wird implizit das Ausgabeverzeichnis des abhängigen Projekts zum Pfad hinzugefügt, damit Dateien zum Zeitpunkt der Verknüpfung mühelos gefunden werden können.
Um die Anwendung bereitzustellen, müssen Sie die DLL an einer geeigneten Stelle platzieren. Folgende Möglichkeiten stehen zur Auswahl:
In demselben Pfad wie die ausführbare Datei.
An einer beliebigen Stelle im Systempfad (der path-Umgebungsvariable).
In der parallelen Assembly. Weitere Informationen finden Sie unter Erstellen von parallelen C/C++-Assemblys.
Arbeiten mit mehreren Projekten
Projekte werden standardmäßig so erstellt, dass alle Ausgabedateien in einem Unterverzeichnis des Projektverzeichnisses erstellt werden. Das Verzeichnis wird auf Basis der Buildkonfiguration benannt (zum Beispiel "Debug" oder "Release"). Damit nebengeordnete Projekte erfolgreich aufeinander verweisen können, müssen in jedem Projekt die Ausgabeverzeichnisse des jeweils anderen Projekts dem Pfad hinzugefügt werden. Dies erfolgt beim Festlegen der Projektabhängigkeiten automatisch. Wenn Sie allerdings keine Abhängigkeiten verwenden, müssen Sie bei der Behandlung dieses Aspekts mit Sorgfalt vorgehen, da die Verwaltung von Builds sehr komplex werden kann. Wenn ein Projekt beispielsweise über Debug- und Releasekonfigurationen verfügt und eine externe Bibliothek aus einem nebengeordneten Projekt umfasst, muss je nach Konfiguration, die erstellt wird, eine andere Bibliotheksdatei verwendet werden. Eine feste Programmierung dieser Pfade kann sich also als kompliziert erweisen.
Alle wichtigen Ausgabedateien (z. B. ausführbare Dateien, Incremental Linker-Dateien und PDB-Dateien) werden in ein gemeinsames Projektmappenverzeichnis kopiert. Zur Vereinfachung der Verknüpfung und Bereitstellung werden demnach bei der Arbeit mit einer Lösung, die mehrere C++-Projekte mit äquivalenten Konfigurationen umfasst, alle Ausgabedateien zentral zusammengefasst. Wenn Sie diese Dateien zusammenhalten, können Sie sicher sein, dass die Anwendung/Bibliothek erwartungsgemäß funktioniert (da gewährleistet ist, dass sich die Dateien im Pfad befinden).
Bei der Bereitstellung in einer Produktionsumgebung kann der Speicherort der Ausgabedateien ein ernstes Problem darstellen. Während der Ausführung von Projekten in der IDE müssen die Pfade zu den enthaltenen Bibliotheken nicht notwendigerweise mit denjenigen in der Produktionsumgebung übereinstimmen. Wenn der Code beispielsweise #using "../../lib/debug/mylib.dll" umfasst und Sie dann mylib.dll an einer anderen relativen Position bereitstellen, generiert die Anwendung zur Laufzeit einen Fehler. Um dies zu verhindern, sollten Sie in #include-Anweisungen in Ihrem Code keine relativen Pfade verwenden. Es wird empfohlen sicherzustellen, dass die erforderlichen Dateien sich im Projektbuildpfad befinden und dass die entsprechenden Produktionsdateien korrekt platziert sind.
So geben Sie den Speicherort von Ausgabedateien an
- Die Einstellungen zum Speicherort der Projektausgabe befinden sich auf den Eigenschaftenseiten des Projekts. Erweitern Sie den Knoten neben Konfigurationseigenschaften, und wählen Sie Allgemein aus. Das Ausgabeverzeichnis wird neben Ausgabeverzeichnis angegeben. Weitere Informationen finden Sie unter Eigenschaftenseite "Allgemein" (Projekt).