QT_DEPLOY_LIBEXEC_DIR

일부 대상 플랫폼에서 프로그램 실행 파일을 배포하기 위한 접두사 상대 하위 디렉터리.

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

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

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

유닉스 계열 운영 체제에서 프로젝트는 배포 스크립트 내에서 ` QT_DEPLOY_LIBEXEC_DIR `를 사용하여, 프로젝트 내부의 보조 실행 파일을 배포할 특정 디렉터리를 하드코딩하지 않도록 해야 합니다.

예를 들어, ` QtWebEngine `를 사용하는 프로젝트는 ` QtWebEngineProcess ` 실행 파일을 이 디렉터리에 배포하게 됩니다.

QT_DEPLOY_LIBEXEC_DIR 기본값은 CMake의 GNUInstallDirs 모듈에서 제공하는 ${CMAKE_INSTALL_LIBEXECDIR} 의 값(일반적으로 libexec)입니다. QT_DEPLOY_LIBEXEC_DIR 의 값을 변경하려면, Core 패키지가 발견되기 전에 프로젝트에서 CMAKE_INSTALL_LIBEXECDIR 를 설정해야 합니다.

QT_DEPLOY_LIBEXEC_DIR 경로는 QT_DEPLOY_PREFIX를 기준으로 상대 경로입니다.

이 변수는 macOS 앱 번들로 배포할 때는 의미가 없으므로, 해당 시나리오에서는 사용해서는 안 됩니다.

예시

cmake_minimum_required(VERSION 3.16...3.22)
project(MyThings)

# The following CMAKE_INSTALL_*DIR variables are used to initialize their
# QT_DEPLOY_*_DIR counterparts.
set(CMAKE_INSTALL_BINDIR "mybindir")
set(CMAKE_INSTALL_LIBDIR "mylibdir")
set(CMAKE_INSTALL_LIBEXECDIR "mylibexecdir")

find_package(Qt6 REQUIRED COMPONENTS Core)
qt_standard_project_setup()

qt_add_executable(MyApp main.cpp)

set(deploy_script "${CMAKE_CURRENT_BINARY_DIR}/deploy_MyApp.cmake")
file(GENERATE OUTPUT ${deploy_script} CONTENT "

set(QT_DEPLOY_PLUGINS_DIR \"mypluginsdir\")
set(QT_DEPLOY_TRANSLATIONS_DIR \"i18n\")

include(\"${QT_DEPLOY_SUPPORT}\")

qt_deploy_runtime_dependencies(
    EXECUTABLE \"\${QT_DEPLOY_BIN_DIR}/$<TARGET_FILE_NAME:MyApp>\"
)")

install(SCRIPT ${deploy_script})

참조: QT_DEPLOY_SUPPORT, QT_DEPLOY_PREFIX, QT_DEPLOY_BIN_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.