qt_deploy_qt_conf

在部署时编写qt.conf文件。

此命令在Qt6包的Core组件中定义，可以像这样加载：

find_package(Qt6 REQUIRED COMPONENTS Core)

与Qt提供的其他大多数CMake命令不同，qt_deploy_qt_conf()只能从部署脚本中调用。它不能直接由项目调用。

此命令在Qt 6.3中引入。

注意：此命令通常不需要直接调用。它被用于其他更高级别的命令，但希望实现更定制化部署逻辑的项目可能会发现它很有用。

摘要

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

描述

当您需要在部署时生成一个qt.conf文件时，请使用此命令。任何由qt.conf支持的路径的默认值都可以用相应的..._DIR选项覆盖。只有当路径与默认值不同时，命令才会将路径写入生成的qt.conf文件。默认值可以在覆盖路径中找到。

file_path参数期望一个绝对路径，该路径指定了应将qt.conf文件写入的位置。可以使用QT_DEPLOY_PREFIX和QT_DEPLOY_BIN_DIR变量动态指定一个相对于部署二进制目录的路径，如下面的示例所示。这有助于避免硬编码一个绝对路径。

示例

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

另请参阅：qt_generate_deploy_app_script()和qt_deploy_runtime_dependencies()。