Ausführen von qmake

Das Verhalten von qmake lässt sich beim Ausführen durch die Angabe verschiedener Optionen in der Befehlszeile anpassen. Diese ermöglichen eine Feinabstimmung des Erstellungsprozesses, liefern nützliche Diagnoseinformationen und können zur Festlegung der Zielplattform für Ihr Projekt verwendet werden.

Befehlssyntax

Die Syntax zum Ausführen von qmake hat die folgende einfache Form:

qmake [mode] [options] files

Betriebsmodi

qmake unterstützt zwei verschiedene Betriebsmodi. Im Standardmodus verwendet qmake die Informationen in einer Projektdatei, um ein Makefile zu generieren, es ist jedoch auch möglich, qmake zur Erstellung von Projektdateien zu verwenden. Wenn Sie den Modus explizit festlegen möchten, müssen Sie ihn vor allen anderen Optionen angeben. Die Option „ mode “ kann einen der folgenden beiden Werte annehmen:

• -makefile
  Die qmake-Ausgabe ist ein Makefile.
• -project
  Die Ausgabe von qmake ist eine Projektdatei.
  

  Hinweis: Es ist wahrscheinlich, dass die erstellte Datei bearbeitet werden muss. Beispielsweise muss die Variable „ QT “ entsprechend den für das Projekt erforderlichen Modulen angepasst werden.

Mit der Variablen „ options “ können Sie sowohl allgemeine als auch modusspezifische Einstellungen festlegen. Optionen, die nur für den Makefile-Modus gelten, werden im Abschnitt „Optionen für den Makefile-Modus“ beschrieben, während Optionen, die die Erstellung von Projektdateien beeinflussen, im Abschnitt „Optionen für den Projektmodus“ beschrieben werden.

Dateien

Das Argument „ files “ stellt eine durch Leerzeichen getrennte Liste aus einer oder mehreren Projektdateien dar.

Allgemeine Optionen

Über die Befehlszeile von qmake lässt sich eine Vielzahl von Optionen angeben, um den Build-Prozess anzupassen und die Standardeinstellungen für Ihre Plattform zu überschreiben. Die folgenden grundlegenden Optionen bieten Hilfe zur Verwendung von qmake, legen fest, wo qmake die Ausgabedatei schreibt, und steuern den Umfang der Debugging-Informationen, die an die Konsole ausgegeben werden:

• -help
  qmake wird diese Funktionen erläutern und einige nützliche Hinweise geben.
• -o file
  Die qmake-Ausgabe wird an „ “ umgeleitet. Wird diese Option nicht angegeben, versucht qmake, je nach dem Modus, in dem es ausgeführt wird, einen geeigneten Dateinamen für seine Ausgabe zu verwenden. Wird „-“ angegeben, wird die Ausgabe an stdout umgeleitet. file
  
• -d
  qmake gibt Debugging-Informationen aus. Durch mehrmaliges Hinzufügen von „ “ wird die Ausführlichkeit erhöht. -d

Die für das Projekt verwendete Vorlage wird in der Regel durch die Variable TEMPLATE in der Projektdatei festgelegt. Sie können diese mit den folgenden Optionen überschreiben oder ändern:

• -t tmpl
  qmake überschreibt alle festgelegten „ “-Variablen mit „ “, jedoch erst, TEMPLATE tmplnachdem die .pro-Datei verarbeitet wurde.
• -tp prefix
  qmake fügt „ “ zur Variablen „ “ hinzu. prefix TEMPLATE

Der Umfang der Warnmeldungen kann fein abgestimmt werden, um Ihnen das Auffinden von Problemen in Ihrer Projektdatei zu erleichtern:

• -Wall
  qmake meldet alle bekannten Warnungen.
• -Wnone
  qmake generiert keine Warnmeldungen.
• -Wparser
  qmake generiert nur Parser-Warnungen. Dadurch werden Sie auf häufige Fallstricke und potenzielle Probleme beim Parsen Ihrer Projektdateien hingewiesen.
• -Wlogic
  qmake warnt vor häufigen Fallstricken und potenziellen Problemen in Ihrer Projektdatei. Beispielsweise meldet qmake mehrfach vorkommende Dateien in Listen sowie fehlende Dateien.

Optionen für den Makefile-Modus

qmake -makefile [options] files

Im Makefile-Modus generiert qmake eine Makefile-Datei, die zum Erstellen des Projekts verwendet wird. Zusätzlich können in diesem Modus die folgenden Optionen verwendet werden, um die Art und Weise der Generierung der Projektdatei zu beeinflussen:

• -after
  qmake verarbeitet die auf der Befehlszeile angegebenen Zuweisungen nach den angegebenen Dateien.
• -nocache
  qmake ignoriert die Datei „ “. .qmake.cache
• -nodepend
  qmake generiert keine Abhängigkeitsinformationen.
• -cache file
  qmake verwendet „ “ als Cache-Datei und ignoriert alle anderen gefundenen „.qmake.cache“-Dateien. file
• -spec spec
  qmake verwendet „ “ als Pfad zu Plattform- und Compiler-Informationen und ignoriert den Wert von spec QMAKESPEC.

Sie können qmake-Zuweisungen auch über die Befehlszeile übergeben. Diese werden vor allen angegebenen Dateien verarbeitet. Der folgende Befehl generiert beispielsweise ein Makefile aus test.pro:

qmake -makefile -o Makefile "CONFIG+=test" test.pro

Einige der angegebenen Optionen können jedoch weggelassen werden, da es sich um Standardwerte handelt:

qmake "CONFIG+=test" test.pro

Wenn Sie sicher sind, dass Ihre Variablen erst nach den angegebenen Dateien verarbeitet werden sollen, können Sie die Option „ -after “ übergeben. Wenn diese Option angegeben wird, werden alle Zuweisungen in der Befehlszeile nach der Option „ -after “ zurückgestellt, bis die angegebenen Dateien geparst wurden.

Optionen für den Projektmodus

qmake -project [options] files

Im Projektmodus generiert qmake eine Projektdatei. Zusätzlich können Sie in diesem Modus die folgenden Optionen angeben:

• -r
  qmake durchsucht die angegebenen Verzeichnisse rekursiv.
• -nopwd
  qmake sucht nicht in Ihrem aktuellen Arbeitsverzeichnis nach Quellcode. Es verwendet ausschließlich den angegebenen ` `. files

In diesem Modus kann das Argument „ files “ eine Liste von Dateien oder Verzeichnissen sein. Wenn ein Verzeichnis angegeben wird, wird es in die Variable „DEPENDPATH“ aufgenommen, und der relevante Code daraus wird in die generierte Projektdatei aufgenommen. Wenn eine Datei angegeben wird, wird sie je nach ihrer Erweiterung an die entsprechende Variable angehängt. Beispielsweise werden UI-Dateien zu „FORMS“ hinzugefügt und C++-Dateien zu „SOURCES“.

In diesem Modus können Sie auch Zuweisungen über die Befehlszeile übergeben. In diesem Fall werden diese Zuweisungen an letzter Stelle in die generierte Projektdatei eingefügt.