qt_deploy_qt_conf

Write a qt.conf file at deployment time.

The command is defined in the Core component of the Qt6 package, which can be loaded like so:

 find_package(Qt6 REQUIRED COMPONENTS Core)

Unlike most other CMake commands provided by Qt, qt_deploy_qt_conf() can only be called from a deployment script. It cannot be called directly by the project.

This command was introduced in Qt 6.3.

Synopsis

 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]
 )

Description

Use this command when you need to generate a qt.conf file during deployment. The default value of any path supported by qt.conf can be overridden with the corresponding ..._DIR option. The command will only write a path to the generated qt.conf file if it differs from the default value. The default values can be found at Overriding Paths.

The file_path argument expects an absolute path to the location where the qt.conf file should be written to. The QT_DEPLOY_PREFIX and QT_DEPLOY_BIN_DIR variables can be used to dynamically specify a path relative to the deployment binary directory, as shown in the example below. This helps avoid hard-coding an absolute path.

Example

 # 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})