qt_deploy_translations
실행 파일에 필요한 Qt 번역을 배포합니다.
이 명령은 Qt6 패키지의 Core 구성 요소에 정의되어 있으며, 다음과 같이 로드할 수 있습니다:
find_package(Qt6 REQUIRED COMPONENTS Core)Qt에서 제공하는 대부분의 다른 CMake 명령과 달리, ` qt_deploy_translations() `는 배포 스크립트에서만 호출할 수 있습니다. configure 단계에서 프로젝트가 직접 호출할 수는 없습니다.
이 명령어는 Qt 6.5에서 도입되었습니다.
참고: 이 명령어는 일반적으로 직접 호출할 필요가 없습니다. 이 명령어는 다른 상위 수준 명령어에서 내부적으로 사용되지만, 보다 맞춤화된 배포 로직을 구현하고자 하는 프로젝트에서는 유용하게 사용할 수 있습니다.
구문
qt_deploy_translations(
[CATALOGS catalogs]
[LOCALES locales]
[LCONVERT lconvert_executable]
[VERBOSE]
)설명
응용 프로그램을 설치할 때, 사용된 Qt 모듈에 속하는 번역 파일도 함께 설치하는 것이 바람직할 수 있습니다. ` qt_deploy_translations ` 명령어는 Qt 설치 디렉터리에서 필요한 ` .qm ` 파일을 수집하여, 언어별로 하나의 ` qt_${language}.qm ` 파일로 컴파일합니다. ` .qm ` 파일은 ` QT_DEPLOY_TRANSLATIONS_DIR`에 설치됩니다.
인수
LOCALES 인수는 번역이 배포되어야 할 로케일을 지정합니다. 이는 Qt Linguist 의 번역자용 매뉴얼에 설명된 대로 언어/지역 조합의 목록입니다. 유효한 로케일의 예로는 de, pl 또는 pt_BR 등이 있습니다.
LOCALES 가 생략되면 사용 가능한 모든 로케일이 배포됩니다.
CATALOGS 인수는 배포할 번역 카탈로그 목록을 지정합니다. 이 인수가 생략되면, find_package 를 통해 프로젝트에서 사용되는 모든 Qt 모듈에 속한 카탈로그가 배포됩니다.
LCONVERT 인수는 카탈로그를 결합하는 데 사용되는 lconvert 실행 파일을 지정합니다. 기본적으로 Qt 설치 경로의 lconvert 가 사용됩니다.
디버깅을 위해 VERBOSE 인수를 설정하여 진단 메시지를 표시할 수 있습니다.
예제
다음 예제는 Qt 라이브러리의 덴마크어 및 독일어 번역본을 배포합니다.
qt_deploy_translations(
LOCALES da de
)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.