qt_deploy_qt_conf
Crea un archivo qt.conf en el momento de la implementación.
El comando está definido en el componente « Core » del paquete « Qt6 », que se puede cargar de la siguiente manera:
find_package(Qt6 REQUIRED COMPONENTS Core)A diferencia de la mayoría de los demás comandos de CMake proporcionados por Qt, qt_deploy_qt_conf() solo se puede invocar desde un script de implementación. No se puede invocar directamente desde el proyecto.
Este comando se introdujo en Qt 6.3.
Nota: Normalmente no es necesario llamar aeste comando directamente. Lo utilizan internamente otros comandos de nivel superior, pero puede resultar útil para los proyectos que deseen implementar una lógica de implementación más personalizada.
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
Utiliza este comando cuando necesites generar un archivo qt.conf durante la implementación. El valor predeterminado de cualquier ruta admitida por qt.conf puede sobrescribirse con la opción correspondiente de ..._DIR. El comando solo escribirá una ruta al archivo qt.conf generado si esta difiere del valor predeterminado. Los valores predeterminados se pueden consultar en Sobrescribir rutas.
El argumento file_path espera una ruta absoluta a la ubicación donde debe escribirse el archivo qt.conf. Las variables QT_DEPLOY_PREFIX y QT_DEPLOY_BIN_DIR pueden utilizarse para especificar dinámicamente una ruta relativa al directorio binario de implementación, tal y como se muestra en el ejemplo siguiente. Esto ayuda a evitar codificar de forma fija una ruta absoluta.
Ejemplo
Nota: El ejemplo siguiente pretende que ${QT_DEPLOY_PREFIX} y ${QT_DEPLOY_BIN_DIR} se expandan al ejecutar el script generado. Esto solo funciona si QTP0008 está configurado en NEW. Con el comportamiento OLD, ambas referencias se expanden al tiempo que se reenvían los argumentos, y el script generado acaba con 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})Véanse también qt_generate_deploy_app_script(), qt_deploy_runtime_dependencies() y 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.