qt_deploy_qt_conf
Escribe un archivo qt.conf en el momento del despliegue.
El comando está definido en el componente Core del paquete Qt6, que puede cargarse así:
find_package(Qt6 REQUIRED COMPONENTS Core)
A diferencia de la mayoría de los otros comandos CMake proporcionados por Qt, qt_deploy_qt_conf() sólo puede ser llamado desde un script de despliegue. No puede ser llamado directamente por el proyecto.
Este comando fue introducido en Qt 6.3.
Nota: Este comando normalmente no necesita ser llamado directamente. Es utilizado internamente por otros comandos de nivel superior, pero los proyectos que deseen implementar una lógica de despliegue más personalizada pueden encontrarlo útil.
Sinopsis
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]
)Descripción
Utilice este comando cuando necesite generar un archivo qt.conf durante el despliegue. El valor por defecto de cualquier ruta soportada por qt.conf puede anularse con la opción ..._DIR correspondiente. El comando sólo escribirá una ruta en el archivo qt.conf generado si difiere del valor predeterminado. Los valores por defecto se pueden encontrar en Overriding Paths.
El argumento file_path espera una ruta absoluta a la ubicación donde el archivo qt.conf debe ser escrito. Las variables QT_DEPLOY_PREFIX y QT_DEPLOY_BIN_DIR pueden utilizarse para especificar dinámicamente una ruta relativa al directorio binario de despliegue, como se muestra en el ejemplo siguiente. Esto ayuda a evitar la codificación de una ruta absoluta.
Ejemplo
# 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})Ver también qt_generate_deploy_app_script() y qt_deploy_runtime_dependencies().
© 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.