lrelease 사용법

lrelease 명령줄 도구는 TS 파일을 기반으로 QM 파일을 생성합니다. QM 파일 형식은 현지화된 애플리케이션에서 사용하는 압축된 바이너리 형식입니다. 이 형식은 번역 내용을 매우 빠르게 조회할 수 있게 해줍니다.

qmake로 빌드할 때는 명령줄이나 .pro 파일에서 처리할 파일을 지정하십시오.

CMake를 사용하여 빌드할 때는 CMake 명령을 사용하여 TS 파일을 생성하거나 업데이트하고 이를 QM 파일로 변환하는 타깃을 추가하십시오. lrelease 도구는 타깃을 빌드할 때 명령에 전달하는 옵션과 함께 실행됩니다.

초기 테스트 버전부터 최종 릴리스 버전에 이르기까지, 애플리케이션을 릴리스할 때마다 lrelease 를 실행하십시오. 애플리케이션이 실행되는 데 QM 파일이 반드시 필요한 것은 아니지만, QM 파일이 있으면 애플리케이션이 이를 감지하여 자동으로 사용합니다.

참고: lrelease 도구는 사용자가 완료로 표시한 번역만 통합합니다. 그렇지 않은 경우, 원본 텍스트를 대신 사용합니다.

lrelease 구문

lrelease [options] -project project-file
lrelease [options] ts-files [-qm qm-file]

사용 위치:

options 는 하나 이상의 lrelease 옵션을 의미합니다.
project-file 는 프로젝트 구성 파일입니다.
ts-files 는 QM 파일의 입력으로 사용될 TS 파일들입니다.
qm-file 생성할 QM 파일의 이름입니다.

참고: lrelease 에 .pro 파일을전달하는 방법은 더 이상 권장되지 않습니다. qmake를 사용할 때는 lrelease-pro 도구를 사용하거나 lrelease.prf 기능을 활용하십시오.

최신 도움말을 보려면 다음을 입력하십시오:

lrelease -help

lrelease 옵션

옵션	작업
`-help`	최신 도움말 정보를 표시하고 종료합니다.
`-idbased`	사용 중단됨. 이 플래그는 더 이상 필요하지 않으며 향후 버전에서 제거될 예정입니다. 이 플래그는 ID 기반 변환을 활성화하는 데 사용되었습니다.
`-compress`	QM 파일을 압축합니다.
`-nounfinished`	완성되지 않은 번역은 포함하지 않습니다.
`-fail-on-invalid`	다음 검사에서 실패한 번역이 발견되면 작업을 중단합니다: 단축키 유효성 검사 주변 공백의 유효성 검사 종료 구두점 유효성 검사 자리 표시자의 유효성 검사 자세한 내용은 Qt Linguist 도움말을 참조하십시오.
`-fail-on-unfinished`	미완성 번역이 발견되면 오류를 발생시킵니다
`-removeidentical`	번역된 텍스트가 원문과 동일한 경우, 해당 메시지를 제외합니다.
`-markuntranslated <prefix>`	메시지에 실제 번역이 없는 경우, 지정된 문자열을 접두사로 붙인 원본 텍스트를 대신 사용합니다.
`-project <filename>`	JSON 형식으로 프로젝트 설명이 포함된 파일의 이름입니다. `lupdate-pro -dump-json` 를 사용하여 .pro 파일에서 이 파일을 생성할 수 있습니다.
`-silent`	현재 수행 중인 작업에 대한 설명을 표시하지 않습니다.
`-verbose`	현재 수행 중인 작업을 설명합니다(기본값).
`-version`	`lrelease` 의 버전을 표시하고 종료합니다.

예시

CMake에서 lrelease 사용

CMake로 빌드할 때는 CMake 명령어를 사용하여 CMakeLists.txt 파일에 대상에 대한 번역을 추가한 다음, 해당 대상을 빌드합니다.

다음 옵션 중 하나를 선택하십시오:

app과 같은 타깃에 qt_add_translations를 사용하십시오. 이렇게 하면 qt_add_lupdate 및 qt_add_lrelease가 호출됩니다.
타깃에 ` qt_add_lrelease `를 사용하십시오.

해당 타깃(예: ` app_lrelease`)을 빌드하여 해당 타깃의 .qm 파일을 업데이트하십시오. 모든 타깃의 .qm 파일을 업데이트하려면 ` release_translations` 타깃을 빌드하십시오.

qmake에서 lrelease 사용

프로젝트 파일을 지정하지 않고 lrelease 를 실행하려면:

lrelease.exe main_en.ts languages\main_fr.ts

lupdate 사용 lupdate-pro 사용

© 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.