QT_DEPLOY_PREFIX

배포의 기본 위치.

이 변수는 QT_DEPLOY_SUPPORT에 지정된 스크립트에 의해 정의됩니다. 이 변수는 설치 과정 중 또는 빌드 후 규칙에서 배포의 일부로만 사용되어야 합니다.

참고: 이는 저수준 배포 API 변수이며, qt_generate_deploy_app_script와 같은 상위 수준 API 명령어로 처리되지 않는 고급 사용 사례에서만 사용해야 합니다.

이 변수는 Qt 6.3에서 도입되었습니다.

QT_DEPLOY_PREFIX 기본 배포 디렉터리를 지정합니다. 다른 QT_DEPLOY_..._DIR 변수들은 이 위치를 기준으로 상대 경로로 간주되어야 합니다. QT_DEPLOY_PREFIX 의 값은 상대 경로이거나 절대 경로일 수 있으므로, 프로젝트에서는 어떤 상황에서도 특정 유형을 가정해서는 안 됩니다. 상대 경로는 설치 시점에 빌드 도구(ninja, make 등)가 인식하는 현재 작업 디렉터리를 기준으로 처리되는 것으로 간주됩니다.

기본값은 $ENV{DESTDIR}${CMAKE_INSTALL_PREFIX} 이며, 이는 CMake가 설치 중에 사용하는 기본 위치입니다. 이 값이 빈 문자열로 평가되면, 기본값은 대신 점(.)이 되며, 이는 일반적으로 빌드 후 규칙의 일부로 배포할 때 적절한 값입니다. 이 2단계 대체 로직을 통해 프로젝트는 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.