qt_deploy_qt_conf
Erstellen Sie zum Zeitpunkt der Bereitstellung eine qt.conf-Datei.
Der Befehl ist in der Komponente „ Core “ des Pakets „ Qt6 “ definiert, die wie folgt geladen werden kann:
find_package(Qt6 REQUIRED COMPONENTS Core)Im Gegensatz zu den meisten anderen von Qt bereitgestellten CMake-Befehlen kann „ qt_deploy_qt_conf() “ nur aus einem Deployment-Skript heraus aufgerufen werden. Er kann nicht direkt vom Projekt aus aufgerufen werden.
Dieser Befehl wurde in Qt 6.3 eingeführt.
Hinweis: Dieser Befehl muss in der Regel nicht direkt aufgerufen werden. Er wird intern von anderen übergeordneten Befehlen verwendet, kann jedoch für Projekte nützlich sein, die eine individuellere Bereitstellungslogik implementieren möchten.
Syntax
qt_deploy_qt_conf(file_path
[PREFIX prefix]
[DOC_DIR doc_dir]
[HEADERS_DIR headers_dir]
[LIB_DIR lib_dir]
[LIBEXEC_DIR libexec_dir]
[BIN_DIR bin_dir]
[PLUGINS_DIR plugins_dir]
[QML_DIR qml_dir]
[ARCHDATA_DIR archdata_dir]
[DATA_DIR data_dir]
[TRANSLATIONS_DIR translations_dir]
[EXAMPLES_DIR examples_dir]
[TESTS_DIR test_dir]
[SETTINGS_DIR settings_dir]
)Beschreibung
Verwenden Sie diesen Befehl, wenn Sie während der Bereitstellung eine qt.conf-Datei generieren müssen. Der Standardwert jedes von „ qt.conf “ unterstützten Pfads kann mit der entsprechenden Option „ ..._DIR “ überschrieben werden. Der Befehl schreibt nur dann einen Pfad in die generierte Datei „ qt.conf “, wenn dieser vom Standardwert abweicht. Die Standardwerte finden Sie unter „Pfade überschreiben“.
Das Argument „ file_path “ erwartet einen absoluten Pfad zu dem Speicherort, an dem die Datei „ qt.conf “ geschrieben werden soll. Die Variablen `QT_DEPLOY_PREFIX ` und `QT_DEPLOY_BIN_DIR ` können verwendet werden, um einen Pfad relativ zum Verzeichnis der Bereitstellungsbinärdateien dynamisch anzugeben, wie im folgenden Beispiel gezeigt. Dadurch lässt sich die feste Codierung eines absoluten Pfads vermeiden.
Beispiel
Hinweis: Das folgende Beispiel sieht vor, dass „ ${QT_DEPLOY_PREFIX} “ und „ ${QT_DEPLOY_BIN_DIR} “ bei der Ausführung des generierten Skripts expandiert werden. Dies funktioniert nur, wenn QTP0008 auf „ NEW “ gesetzt ist. Bei der Einstellung „ OLD “ werden beide Verweise expandiert, während die Argumente weitergeleitet werden, und das generierte Skript enthält schließlich „ qt_deploy_qt_conf("//qt.conf") “.
# The following script must only be executed at install time
qt_policy(SET QTP0008 NEW)
qt_generate_deploy_script(
OUTPUT_SCRIPT deploy_script
CONTENT "
qt_deploy_qt_conf(\"\${QT_DEPLOY_PREFIX}/\${QT_DEPLOY_BIN_DIR}/qt.conf\"
DATA_DIR \"./custom_data_dir\"
TRANSLATIONS_DIR \"./custom_translations_dir\"
)
")
install(SCRIPT ${deploy_script})Siehe auch qt_generate_deploy_app_script(), qt_deploy_runtime_dependencies() und QTP0008.
© 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.