QT_DEPLOY_PREFIX
部署的基址。
该变量由QT_DEPLOY_SUPPORT 指定的脚本定义。它仅应在安装过程中的部署环节或构建后规则中使用。
注意:这是一个 低级部署 API 变量,仅应用于高级用例,即那些未被更高层级的 API 命令(如qt_generate_deploy_app_script)涵盖的情况。
该变量于 Qt 6.3 版本中引入。
QT_DEPLOY_PREFIX 该变量指定基础部署目录。其他QT_DEPLOY_..._DIR 变量应以此位置为基准。QT_DEPLOY_PREFIX 的值可以是相对路径或绝对路径,因此项目在任何情况下都不应预设其为其中一种类型。 相对路径应被视为相对于安装时构建工具(如 ninja、make 等)所识别的当前工作目录。
默认值为$ENV{DESTDIR}${CMAKE_INSTALL_PREFIX} ,这是 CMake 在安装过程中使用的基目录。 如果该路径的计算结果为空字符串,则默认值将改为点 (.),这在作为后构建规则的一部分进行部署时通常是合适的值。这种两步回退逻辑确保项目可以假设QT_DEPLOY_PREFIX 不会是空字符串,因此可以安全地将其用作路径的一部分,例如${QT_DEPLOY_PREFIX}/${QT_DEPLOY_BIN_DIR} 。
若要更改QT_DEPLOY_PREFIX 的值,可按照“命令行 cmake 调用”中的说明,通过自定义CMAKE_INSTALL_PREFIX来配置项目。
还可以使用DESTDIR环境变量来修改最终的安装位置,从而调整部署位置。
项目通常很少需要使用该变量。在典型场景下,部署脚本应假设工作目录已设置为安装根目录,并仅使用相对于前缀的QT_DEPLOY_..._DIR 变量。
另请参阅 QT_DEPLOY_SUPPORT、QT_DEPLOY_BIN_DIR、QT_DEPLOY_LIBEXEC_DIR、QT_DEPLOY_LIB_DIR、QT_DEPLOY_PLUGINS_DIR、QT_DEPLOY_QML_DIR 以及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.