Qt/C++ - Lektion 025. Erstellen von Projektdateien

sources, headers, qt, config, libs, qt5, qmake

Das Dateiprojekt enthält alle Informationen, die qmake benötigt, um Ihre Anwendung, Bibliothek oder Ihr Plugin zu erstellen. Grundsätzlich verwenden Sie eine Reihe von Deklarationen, um Ressourcen in einem Projekt anzugeben, aber die Unterstützung einfacher Programmierkonstrukte ermöglicht es Ihnen, verschiedene Buildprozesse für verschiedene Plattformen und Umgebungen zu beschreiben.

Elemente der Projektdatei

Das von qmake verwendete Projektdateiformat kann verwendet werden, um sowohl einfache als auch ziemlich komplexe Systeme zu unterstützen. Ein einfaches Dateiprojekt verwendet einen einfachen deklarativen Stil, der Variablen deklariert, um die Quell- und Headerdateien im Projekt zu identifizieren. Komplexe Projekte können Thread-Strukturen verwenden, um den Build-Prozess zu steuern.

Variablen

In einer Projektdatei werden Variablen verwendet, um eine Liste von Zeichenfolgen zu speichern. Im einfachsten Projekt informieren diese Variablen qmake über die zu verwendenden Einstellungsoptionen oder liefern die Dateinamen und Pfade, die während des Build-Prozesses verwendet werden sollen.

qmake sucht in jeder Projektdatei nach diesen Variablen und wird vom Inhalt verwendet, um zu bestimmen, was in das Makefile geschrieben werden soll. Zum Beispiel die Liste der Werte in den HEADERS und SOURCES Variablen werden verwendet, um qmake über die Quell- und Header-Dateien in einigen Verzeichnissen zu informieren.

Variablen können auch intern verwendet werden, um temporäre Wertelisten zu speichern, und bestehende Wertelisten können überschrieben oder mit neuen Werten angereichert werden.

Einer Variablen eine Werteliste zuweisen:

HEADERS = mainwindow.h paintwidget.h

Die Liste der Variablenwerte wird wie folgt erweitert:

SOURCES = main.cpp mainwindow.cpp \
          paintwidget.cpp
CONFIG += console

Hinweis: Die erste Einstellung von Werten umfasst nur diejenigen Werte, die in derselben Zeile mit der Variable HEADERS angegeben sind. Die zweite Deklaration trennt die Werte wie in den * SOURCES * Variable, getrennt durch einen Backslash ("\").

Die Variable CONFIG ist eine weitere spezielle Variable, die von qmake verwendet wird, wenn das Makefile generiert wird.

Liste der Variablen

Nachfolgend finden Sie eine Liste der am häufigsten verwendeten Variablen und eine Beschreibung ihres Inhalts.

• KONFIG - Grundlegende Projekteinstellungen
• DESTDIR - Verzeichnis, in dem die binäre oder ausführbare Datei abgelegt wird
• FORMS - Liste der UI-Dateien, die die Benutzeroberfläche implementieren
• HEADERS - Liste der Namen der Header-Dateien (.h) und Pfade zu ihnen
• QT - Liste der im Projekt verwendeten Qt-Module
• RESSOURCEN - Liste der Ressourcendateien (.qrc), die im endgültigen Projekt enthalten sind.
• SOURCES - Liste der Quellcodedateien, die beim Erstellen des Projekts verwendet werden.
• VORLAGE - im Projekt verwendete Vorlage. Definiert, was das Projekt nach der Kompilierung, Anwendung, Bibliothek oder Plugin sein wird.

Der Inhalt von Variablen kann anderen Variablen zugewiesen werden, indem Sie die Namen anderer Variablen durch zwei $-Zeichen ersetzen.

Leerzeichen

Normalerweise werden Leerzeichen verwendet, um Werte in Variablen zu trennen. Um eine Variable anzugeben, deren Name ein Leerzeichen enthält, müssen Sie die Variable in Klammern setzen:

DEST = "Program Files"

In Klammern eingeschlossener Text zählt als ein Element in der Variablenliste. Eine ähnliche Vorgehensweise gilt auch in anderen Fällen. Wenn Sie beispielsweise Pfade zu Dateien angeben, die Leerzeichen enthalten:

win32:INCLUDEPATH += "C:/mylibs/extra headers"
unix:INCLUDEPATH += "/home/user/extra headers"

Bemerkungen

Normalerweise fügen Sie Ihren Projektdateien Kommentare hinzu. Kommentare beginnen mit # und werden bis zum Ende einer Zeile fortgesetzt.

# Comments usually start at the beginning of a line, but they
# can also follow other content on the same line.

Eingebaute Funktionen und Flusskontrolle

qmake bietet mehrere integrierte Funktionen zum Einbinden des Inhalts von Variablen. Eine häufig verwendete Funktion in einfachen Projekten ist die include () Funktion, die einen Dateinamen als Argument verwendet. Der Inhalt der Datei wird in das Projekt eingebunden, in dem die include-Funktion verwendet wurde Die include-Funktion wird normalerweise verwendet, um andere Projektdateien einzuschließen.

include(other.pro)

Die Unterstützung bedingter Strukturen stellt Bereiche zur Verfügung, die sich wie Deklarationen in einer Programmiersprache verhalten:

win32 {
    SOURCES += paintwidget_win.cpp
}

Die Zuweisung innerhalb der Klammern wird ausgeführt, wenn wahr. In diesem Fall muss im Parameter CONFIG win32 gesetzt werden. Dies geschieht in Windows automatisch. Die öffnende Klammer muss sich in derselben Zeile wie die Bedingung befinden.

Komplexere Operationen mit Variablen erfordern normalerweise Schleifen, die von integrierten Funktionen wie find(), unique(), count() bereitgestellt werden. Diese und viele andere Funktionen bieten String- und Pfadverwaltung mit Unterstützung für Eingabe und Aufruf externer Tools. ...

Projektvorlagen

Die Variable TEMPLATE wird verwendet, um den Typ des zu erstellenden Projekts zu deklarieren. Wenn es nicht in der Projektdatei deklariert ist, erstellt qmake das Projekt als Anwendung und generiert ein Makefile oder gleichwertiges.

Im Folgenden sind die verfügbaren Projekttypen zum Generieren von qmake und ihre Beschreibungen aufgeführt.

• App (Standard) - Makefile wird in die Anwendung integriert
• lib - Makefile baut in eine Bibliothek ein
• aux - Das Makefile wird nicht gesammelt. Wird verwendet, wenn kein Compiler erforderlich ist, aber ein Ziel erstellt werden muss, beispielsweise wenn das Projekt in einer interpretierten Sprache geschrieben ist.
• Unterverzeichnisse - Das Makefile enthält die Regeln für die Unterverzeichnisse, die mit der Variablen SUBDIRS angegeben werden Jedes Unterverzeichnis muss eine eigene Projektdatei enthalten.
• vcapp - Visual Studio-Projektdatei zum Einbinden in die Anwendung
• vclib - Visual Srudio-Projektdatei zum Einbinden in die Bibliothek
• vcsubdirs - Visual Studio-Projektdatei zum Erstellen eines Projekts in Unterverzeichnissen

Wenn Unterverzeichnisse verwendet werden, generiert qmake ein Makefile für jedes Unterverzeichnis, führt alle gefundenen Projektdateien aus und führt das Make-Dienstprogramm auf dem neu erstellten Makefile aus. Die Variable SUBDIRS wird verwendet, um enthalten eine Liste aller Unterverzeichnisse, mit denen die Arbeit erledigt wird.

Grundkonfiguration

Die Variable CONFIG gibt die im Projekt auszuführenden Parameter und Funktionen an.

Ein Projekt kann im Debug-Modus und im Release-Modus oder in beiden erstellt werden. Werden Debug und Release gleichzeitig angegeben, dann wird letzteres wirksam. Wenn debug \ _und \ _release angegeben ist, werden beide Versionen des Projekts erstellt. Das von qmake generierte Makefile enthält eine Regel, die beide Versionen erstellt. Dies kann wie folgt erfolgen.

make all

Добавление **build_all**в переменную **CONFIG** создаёт правило по умолчанию, когда собирается проект.

Hinweis: Die Variable CONFIG kann auch Build-Bedingungen haben, wenn bestimmte Parameter zum Erstellen des Projekts verwendet werden oder nicht.

CONFIG(opengl) {
    message(Building with OpenGL support.)
} else {
    message(OpenGL support is not available.)
}

In diesem Fall sind verschiedene Konfigurationen für Debug- und Release-Builds enthalten.

Hinweis: Einige dieser Optionen werden nur wirksam, wenn sie mit der Build-Plattform übereinstimmen.

• qt - Das Projekt ist eine Qt-Anwendung und muss mit der Qt-Bibliothek verknüpft werden. Sie müssen die QT-Variable verwenden, um das Hinzufügen von Qt-Modulen zu steuern, die zum Erstellen Ihrer Anwendung erforderlich sind. Dieser Wert wird standardmäßig hinzugefügt, Sie können ihn jedoch mit qmake für ein Nicht-Qt-Projekt entfernen.
• x11 - Das Projekt ist eine x11-Anwendung oder Bibliothek. Dieser Wert ist nicht erforderlich, wenn das Ziel Qt ist.

Anwendungsvorlagen und Bibliotheken bieten Ihnen speziellere Einstellungen für den Buildprozess. Wenn Ihre Anwendung beispielsweise die Qt-Bibliothek verwendet und Sie im Debug-Modus erstellen möchten, sollte Ihr Projekt die folgende Zeile enthalten:

CONFIG += qt debug

Hinweis: Sie müssen "+ =" und nicht "=" verwenden, sonst fügt qmake nicht mit den Qt-Einstellungen hinzu.

Qt-Bibliotheken deklarieren

Wenn die Variable CONFIG den Wert qt enthält, wird die qmake-Unterstützung für Qt-Anwendungen aktiviert. Dadurch kann bestimmt werden, welche Qt-Module in einer Anwendung verwendet werden. Dies hat den Vorteil, dass über die Variable QT nur die benötigten Bibliotheken und Module deklariert werden können. Beispielsweise können wir die Module XML und network wie folgt aktivieren:

QT += network xml

Hinweis: QT beinhaltet standardmäßig die core und gui Module, sowie die XML und Netzwerkmodule Folgende Zuordnungsart von Modulen zu einer Variablen enthält nicht core und gui und führt zu Kompilierungsfehlern.

QT = network xml # This will omit the core and gui modules.

Wenn Sie ein Projekt ohne das gui-Modul erstellen möchten, müssen Sie es mit dem folgenden "-="-Operator ausschließen.

QT -= gui # Only the core module is used.

Anpassungsfunktionen

qmake kann auf erweiterte Anpassungsfunktionen eingestellt werden, die in den .prf-Dateien angegeben werden. Diese erweiterten Funktionen bieten oft Unterstützung für benutzerdefinierte Tools während des Buildprozesses. Um Funktionen für den Build-Prozess hinzuzufügen, fügen Sie den Funktionsnamen zur Variable CONFIG. hinzu

Zum Beispiel kann qmake so konfiguriert werden, dass es mit externen Bibliotheken erstellt wird, die pkg-config unterstützen, wie zum Beispiel D-Bus und ogg Bibliotheken.

CONFIG += link_pkgconfig
PKGCONFIG += ogg dbus-1

Andere Bibliotheken deklarieren

Wenn Sie in Ihrem Projekt neben Qt-Modulen andere Bibliotheken verwenden, müssen Sie diese in der Projektdatei angeben.

Die Pfade, die qmake nach Bibliotheken sucht, werden in der LIBS-Variablen angegeben. Sie können den Pfad zur Bibliothek im Unix-Stil angeben.

LIBS += -L/usr/local/lib -lmath

Auf ähnliche Weise können auch Pfade mit Header-Dateien mit der Variable INCLUDEPATH angegeben werden

INCLUDEPATH = c:/msdev/include d:/stl/include