CMake-Befehlsreferenz CMake-Eigenschaftsreferenz

CMake-Variablenreferenz

Qt-Build-Variablen

Beim Erstellen von Qt können Sie CMake-Variablen verwenden, um das Ergebnis der Erstellung zu steuern.

Variable	Beschreibung
QT_HOST_PATH	Pfad zur Qt-Installation auf dem Host, aus der Host-Tools während eines anderen Qt-Builds verwendet werden können, sei es ein regulärer Build oder ein Cross-Build.
`QT_FORCE_BUILD_TOOLS`	Erzwingt die Verwendung der Host-Tools, selbst wenn bereits Host-Tools gefunden wurden. Nützlich beim Cross-Compiling von Qt, um sicherzustellen, dass das SDK über cross-kompilierte Tools verfügt.
`QT_FORCE_FIND_TOOLS`	Verwendet Qt-Tools aus dem vorgefertigten Qt-Paket unter `QT_HOST_PATH`, wenn keine Cross-Kompilierung erfolgt. Die Variable wirkt sich nur aus, wenn „ `QT_FORCE_BUILD_TOOLS` “ auf „ `ON` “ gesetzt ist. Andernfalls hat „ `QT_FORCE_FIND_TOOLS` “ keinen Einfluss auf das Standardverhalten.

Modulvariablen

Mit find_package geladene Qt-Module setzen verschiedene Variablen.

Hinweis: Sie müssen selten direkt auf diese Variablen zugreifen. Gängige Aufgaben wie das Verknüpfen mit einem Modul sollten über die von jedem Modul definierten Bibliotheksziele erfolgen.

Beispielsweise stellt „ find_package(Qt6 COMPONENTS Widgets) “ bei erfolgreicher Ausführung die folgenden Variablen zur Verfügung:

Variable	Beschreibung
`Qt6Widgets_COMPILE_DEFINITIONS`	Eine Liste von Kompilierungsdefinitionen, die beim Erstellen der Bibliothek verwendet werden sollen.
`Qt6Widgets_DEFINITIONS`	Eine Liste von Definitionen, die beim Erstellen in Verbindung mit der Bibliothek verwendet werden sollen.
`Qt6Widgets_EXECUTABLE_COMPILE_FLAGS`	Eine Zeichenkette mit Flags, die beim Erstellen von ausführbaren Dateien mit der Bibliothek verwendet werden sollen.
`Qt6Widgets_FOUND`	Ein boolescher Wert, der angibt, ob das Modul erfolgreich gefunden wurde.
`Qt6Widgets_INCLUDE_DIRS`	Eine Liste von Include-Verzeichnissen, die beim Erstellen der Bibliothek zu verwenden sind.
`Qt6Widgets_LIBRARIES`	Der Name des importierten Ziels für das Modul: `Qt6::Widgets`
`Qt6Widgets_PRIVATE_INCLUDE_DIRS`	Eine Liste privater Include-Verzeichnisse, die beim Erstellen mit der Bibliothek und bei der Verwendung der privaten Qt-API verwendet werden sollen.
`Qt6Widgets_VERSION`	Eine Zeichenkette, die die Version des Moduls enthält.

Für alle mit „ find_package “ gefundenen Pakete stehen Entsprechungen dieser Variablen zur Verfügung; bei diesen wird zwischen Groß- und Kleinschreibung unterschieden.

Installationsvariablen

Darüber hinaus gibt es auch Variablen, die sich nicht auf ein bestimmtes Paket, sondern auf die Qt-Installation selbst beziehen.

Variable	Beschreibung
`QT_DEFAULT_MAJOR_VERSION`	Eine Ganzzahl, die die Qt-Version steuert, an die `qt_` -Befehle bei gemischten Qt-5- und Qt-6-Projekten weiterleiten. Sie muss vor den jeweiligen `find_package()` -Aufrufen entweder auf `5` oder `6` gesetzt werden. Ist der Wert auf „ `5` “ gesetzt, rufen Befehle, die mit „ `qt_` “ beginnen, ihre Entsprechungen auf, die mit „ `qt5_` “ beginnen. Ist der Wert auf „ `6` “ gesetzt, rufen sie ihre Entsprechungen auf, die mit „ `qt6_` “ beginnen. Ist keine Einstellung vorhanden, definiert der erste Aufruf von „ `find_package` “ die Standardversion.
`QT_LIBINFIX`	Eine Zeichenkette, die das in Bibliotheksnamen verwendete Suffix enthält, wenn Qt mit „ `-libinfix` “ konfiguriert ist.
`QT_NO_CREATE_VERSIONLESS_FUNCTIONS`	Blendet Befehle aus, die mit „ `qt_` “ beginnen, und lässt nur die versionsbezogenen Befehle übrig, die mit „ `qt6_` “ beginnen.
`QT_NO_CREATE_VERSIONLESS_TARGETS`	Blendet die importierten Ziele aus, die mit „ `Qt::` “ beginnen. Stattdessen müssen Sie die Ziele verwenden, die mit „ `Qt6::` “ beginnen.
`QT_VISIBILITY_AVAILABLE`	Unter Unix ein boolescher Wert, der angibt, ob Qt-Bibliotheken und -Plugins mit „ `-fvisibility=hidden` “ kompiliert wurden. Das bedeutet, dass nur ausgewählte Symbole exportiert werden.

Projektvariablen

Diese Variablen können die von Qt bereitgestellten CMake-Befehle beeinflussen. Sie können vom Projekt, einer Toolchain-Datei oder anderen Paketen von Drittanbietern gesetzt werden.

`Qt6::Core`

ANDROID_NDK_HOST_SYSTEM_NAME	Android-spezifische Architektur des Host-Systems
ANDROID_SDK_ROOT	Speicherort des Android SDK
QT_ANDROID_ABIS	Liste der ABIs, für die die Projektpakete erstellt werden
QT_ANDROID_APPLICATION_ARGUMENTS	Liste der an Android-Anwendungen zu übergebenden Argumente
QT_ANDROID_BUILD_ALL_ABIS	Ermöglicht die Erstellung von Multi-ABI-Paketen unter Verwendung der automatisch erkannten Liste der Qt-for-Android-SDKs
QT_ANDROID_CREATE_SYMLINKS_ONLY	Erstellt nur symbolische Links für Abhängigkeiten im Gradle-Projektverzeichnis
QT_ANDROID_DEPLOYMENT_TYPE	Erzwingt oder deaktiviert die Signierung von Release-Paketen unabhängig vom Build-Typ
QT_ANDROID_GENERATE_JAVA_QTQUICKVIEW_CONTENTS	Aktiviert die Generierung von QtQuickViewContent-basierten Klassen
QT_ANDROID_GRADLE_MULTI_MODULE	Erstellt das Android-Paket aus einem Gradle-Projekt mit mehreren Modulen
QT_ANDROID_MULTI_ABI_FORWARD_VARS	Ermöglicht die gemeinsame Nutzung von CMake-Variablen in Multi-ABI-Builds
QT_ANDROID_POST_BUILD_GRADLE_CLEANUP	Führt nach der Erstellung des Android-Pakets eine Gradle-Bereinigung durch
QT_ANDROID_SIGN_AAB	Signiert das .aab-Paket mit dem angegebenen Keystore, Alias und Speicherpasswort
QT_ANDROID_SIGN_APK	Signiert das Paket mit dem angegebenen Keystore, Alias und Speicherpasswort
QT_DEPLOY_BIN_DIR	Präfix-relatives Unterverzeichnis für die Bereitstellung von Laufzeit-Binärdateien auf bestimmten Zielplattformen
QT_DEPLOY_IGNORED_LIB_DIRS	Verzeichnisse, die von der Suche nach Laufzeitabhängigkeiten ausgeschlossen sind
QT_DEPLOY_LIBEXEC_DIR	Präfix-relatives Unterverzeichnis für die Bereitstellung von Programm-Executables auf einigen Zielplattformen
QT_DEPLOY_LIB_DIR	Präfix-relatives Unterverzeichnis für die Bereitstellung von Bibliotheken auf einigen Zielplattformen
QT_DEPLOY_PLUGINS_DIR	Präfixrelatives Unterverzeichnis für die Bereitstellung von Qt-Plugins auf einigen Zielplattformen
QT_DEPLOY_PREFIX	Basisverzeichnis für eine Bereitstellung
QT_DEPLOY_QML_DIR	Präfix-relatives Unterverzeichnis für die Bereitstellung von QML-Plugins auf einigen Zielplattformen
QT_DEPLOY_SUPPORT	Name der Datei, die zum Einrichten der Bereitstellungsunterstützung eingebunden werden muss
QT_DEPLOY_TRANSLATIONS_DIR	Präfix-relatives Unterverzeichnis für die Bereitstellung von Qt-Übersetzungen auf einigen Zielplattformen
QT_ENABLE_VERBOSE_DEPLOYMENT	Aktiviert den ausführlichen Modus der Bereitstellungswerkzeuge
QT_HOST_PATH	Speicherort der Qt-Host-Installation bei der Cross-Kompilierung
QT_I18N_SOURCE_LANGUAGE	Legt die Sprache der übersetzbaren Zeichenfolgen fest
QT_I18N_TRANSLATED_LANGUAGES	Liste der Sprachen, die für die Internationalisierung des Projekts verwendet werden sollen
QT_IOS_LAUNCH_SCREEN	Pfad zum iOS-Startbildschirm-Storyboard, das von allen Zielplattformen verwendet wird
QT_NO_COLLECT_BUILD_TREE_APK_DEPS	Verhindert das Erfassen von projektintern erstellten Shared-Library-Zielen bei der Android-Bereitstellung
QT_NO_COLLECT_IMPORTED_TARGET_APK_DEPS	Verhindert das Sammeln importierter Ziele bei der Android-Bereitstellung
QT_NO_SET_XCODE_BUNDLE_IDENTIFIER	Deaktiviert die Bereitstellung einer Fallback-App-Bundle-ID während der Zielfinalisierung unter iOS
QT_NO_SET_XCODE_DEVELOPMENT_TEAM_ID	Deaktiviert die Angabe einer Fallback-Team-ID während der Zielfinalisierung unter iOS
QT_NO_STANDARD_PROJECT_SETUP	Verhindert, dass nachfolgende Aufrufe von `qt_standard_project_setup()` Änderungen vornehmen
QT_PATH_ANDROID_ABI_<ABI>	Variablengruppe zur Angabe des Pfads zu Qt für Android für die entsprechende ABI
QT_USE_TARGET_ANDROID_BUILD_DIR	Aktiviert die Verwendung von zielspezifischen Android-Build-Verzeichnissen

`Qt6::InterfaceFramework`

IFCODEGEN_VERBOSE	Aktiviert die ausführliche Protokollierung für alle ifcodegen-Funktionen
QT_IFCODEGEN_TEMPLATE_SEARCH_PATH	Suchpfad für ifcodegen-Vorlagen

`Qt6::Multimedia`

QT_NO_FFMPEG_XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY

Deaktiviert die FFmpeg-Code-Signierung unter iOS

`Qt6::Qml`

QT_QMLLINT_CONTEXT_PROPERTY_DUMP	Aktiviert das Ausgeben von Kontexteigenschaften in Lint-Zielen
QT_QML_GENERATE_AOTSTATS	Steuert, ob die Erfassung von QML-Compiler-Statistiken aktiviert ist
QT_QML_GENERATE_QMLLS_INI	Aktiviert die automatische Generierung von .qmlls.ini-Dateien für QML Language Server
QT_QML_GENERATE_QMLLS_INI_NO_CMAKE_CALLS	Passen den Wert von „no-cmake-calls“ in .qmlls.ini-Dateien an für QML Language Server
QT_QML_NO_CACHEGEN	Deaktiviert die Kompilierung von QML-Dateien in Bytecode oder C++-Code
QT_QML_NO_QML_PREVIEW (global property)	Legt fest, ob die Unterstützung für „qmlpreview“ automatisch für ausführbare Dateien eingerichtet wird, die gegen „Qt6::Qml“ verknüpft sind
QT_QML_OUTPUT_DIRECTORY	Basisausgabeverzeichnis, unter dem QML-Module standardmäßig erstellt werden

Standard-CMake-Variablen

CMAKE_AUTOGEN_BETTER_GRAPH_MULTI_CONFIG

Verbessert den Abhängigkeitsgraphen für Generatoren mit mehreren Konfigurationen

CMake-Befehlsreferenz CMake-Eigenschaftsreferenz

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.