qt_deploy_qt_conf

Schreibt eine qt.conf-Datei zum Zeitpunkt der Bereitstellung.

Der Befehl ist in der Komponente Core des Pakets Qt6 definiert, das auf diese Weise geladen werden kann:

find_package(Qt6 REQUIRED COMPONENTS Core)

Im Gegensatz zu den meisten anderen CMake-Befehlen, die von Qt bereitgestellt werden, kann qt_deploy_qt_conf() nur von einem Deployment-Skript aufgerufen werden. Es kann nicht direkt vom Projekt aufgerufen werden.

Dieser Befehl wurde in Qt 6.3 eingeführt.

Synopse

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 des Deployments eine qt.conf-Datei erzeugen müssen. Der Standardwert eines jeden von qt.conf unterstützten Pfades 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 Overriding Paths.

Das Argument file_path erwartet einen absoluten Pfad zu dem Ort, an den die Datei qt.conf geschrieben werden soll. Die Variablen QT_DEPLOY_PREFIX und QT_DEPLOY_BIN_DIR können verwendet werden, um dynamisch einen Pfad relativ zum Deployment-Binärverzeichnis anzugeben, wie im folgenden Beispiel gezeigt. Dies hilft dabei, das Festcodieren eines absoluten Pfades zu vermeiden.

Beispiel

# The following script must only be executed at install time
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})