QT_DEPLOY_PREFIX

Ubicación base para una implementación.

Esta variable la define el script indicado por QT_DEPLOY_SUPPORT. Solo debe utilizarse como parte del despliegue durante la instalación o en una regla posterior a la compilación.

Nota: Se trata de una variable de la API de implementación de bajo nivel y solo debe utilizarse en casos de uso avanzados que no estén cubiertos por los comandos de la API de nivel superior, como qt_generate_deploy_app_script.

Esta variable se introdujo en Qt 6.3.

QT_DEPLOY_PREFIX Proporciona el directorio base de implementación. Las demás variables de QT_DEPLOY_..._DIR deben considerarse relativas a esta ubicación. El valor de QT_DEPLOY_PREFIX puede ser relativo o absoluto, por lo que los proyectos no deben dar por sentado que es uno u otro en ninguna situación concreta. Se espera que una ruta relativa se considere relativa al directorio de trabajo actual, tal y como lo ve la herramienta de compilación (ninja, make, etc.) en el momento de la instalación.

El valor por defecto es $ENV{DESTDIR}${CMAKE_INSTALL_PREFIX}, que es la ubicación base que utiliza CMake durante la instalación. Si el resultado es una cadena vacía, el valor por defecto será un punto (.), que suele ser el valor adecuado cuando se realiza la implementación como parte de una regla posterior a la compilación. Esta lógica de recurso alternativa en dos pasos garantiza que los proyectos puedan dar por hecho que QT_DEPLOY_PREFIX no será una cadena vacía, por lo que puede utilizarse con seguridad como parte de una ruta como ${QT_DEPLOY_PREFIX}/${QT_DEPLOY_BIN_DIR}.

Para cambiar el valor de QT_DEPLOY_PREFIX, el proyecto se puede configurar con un CMAKE_INSTALL_PREFIX personalizado, tal y como se describe en «Invocación de CMake desde la línea de comandos».

La variable de entorno DESTDIR también se puede utilizar para modificar la ubicación final de la instalación y, por lo tanto, de la implementación.

Los proyectos rara vez deberían necesitar utilizar esta variable. En situaciones habituales, los scripts de implementación deberían dar por hecho que el directorio de trabajo ya está establecido en la ubicación de instalación base y limitarse a utilizar las variables QT_DEPLOY_..._DIR relativas al prefijo.

Véanse también QT_DEPLOY_SUPPORT, QT_DEPLOY_BIN_DIR, QT_DEPLOY_LIBEXEC_DIR, QT_DEPLOY_LIB_DIR, QT_DEPLOY_PLUGINS_DIR, QT_DEPLOY_QML_DIR y QT_DEPLOY_TRANSLATIONS_DIR.

© 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.