QT_DEPLOY_LIB_DIR

일부 대상 플랫폼에서 라이브러리를 배포하기 위한 접두사 상대 하위 디렉터리입니다.

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

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

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

프로젝트에서는 다음 유형의 바이너리를 배포할 때 특정 디렉터리를 하드코딩하지 않도록 배포 스크립트에서 ` QT_DEPLOY_LIB_DIR `를 사용해야 합니다:

Windows 이외의 플랫폼에서 사용되는 공유 라이브러리.
Windows의 임포트 라이브러리.

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

QT_DEPLOY_LIB_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_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.