QT_DEPLOY_PREFIX

Emplacement de base pour un déploiement.

Cette variable est définie par le script nommé par QT_DEPLOY_SUPPORT. Elle ne doit être utilisée que dans le cadre d'un déploiement lors de l'installation ou d'une règle de post-construction.

Note : Il s'agit d'une variable de bas niveau de l'API de déploiement, et ne doit être utilisée que dans des cas d'utilisation avancés qui ne sont pas couverts par les commandes de haut niveau de l'API, comme qt_generate_deploy_app_script.

Cette variable a été introduite dans Qt 6.3.

QT_DEPLOY_PREFIX fournit le répertoire de déploiement de base. Les autres variables QT_DEPLOY_..._DIR doivent être considérées comme relatives à cet emplacement. La valeur de QT_DEPLOY_PREFIX peut être relative ou absolue, les projets ne doivent donc pas supposer l'une ou l'autre dans une situation donnée. Un chemin relatif est censé être traité comme relatif au répertoire de travail actuel, tel qu'il est vu par l'outil de construction (ninja, make, etc.) au moment de l'installation.

La valeur par défaut est $ENV{DESTDIR}${CMAKE_INSTALL_PREFIX}, qui est l'emplacement de base utilisé par CMake lors de l'installation. Si cette valeur est une chaîne vide, la valeur par défaut sera un point (.) à la place, ce qui est généralement la valeur appropriée lors d'un déploiement dans le cadre d'une règle post-construction. Cette logique de repli en deux étapes garantit que les projets peuvent supposer que QT_DEPLOY_PREFIX ne sera pas une chaîne vide, de sorte qu'il peut être utilisé en toute sécurité dans le cadre d'un chemin tel que ${QT_DEPLOY_PREFIX}/${QT_DEPLOY_BIN_DIR}.

Pour modifier la valeur de QT_DEPLOY_PREFIX, le projet peut être configuré avec un CMAKE_INSTALL_PREFIX personnalisé comme décrit dans Invocation cmake en ligne de commande.

La variable d'environnement DESTDIR peut également être utilisée pour modifier l'emplacement de l'installation finale, et donc du déploiement.

Les projets devraient rarement avoir besoin d'utiliser cette variable. Dans des scénarios typiques, les scripts de déploiement devraient supposer que le répertoire de travail est déjà défini à l'emplacement de l'installation de base et se contenter d'utiliser les variables QT_DEPLOY_..._DIR relatives aux préfixes.

Voir aussi QT_DEPLOY_SUPPORT, QT_DEPLOY_BIN_DIR, QT_DEPLOY_LIBEXEC_DIR, QT_DEPLOY_LIB_DIR, QT_DEPLOY_PLUGINS_DIR, QT_DEPLOY_QML_DIR, et 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.