릴리스 사용

lrelease 명령줄 도구는 TS 파일에서 QM 파일을 생성합니다. QM 파일 형식은 로컬라이즈된 애플리케이션에서 사용하는 압축 바이너리 형식입니다. 번역을 매우 빠르게 조회할 수 있습니다.

qmake로 빌드할 때는 명령줄 또는 .pro 파일에서 처리할 파일을 지정하세요.

CMake로 빌드할 때는 CMake 명령을 사용하여 TS 파일을 생성하거나 업데이트하는 대상을 추가하고 이를 QM 파일로 변환합니다. lrelease 도구는 대상을 빌드할 때 명령에 전달한 옵션으로 실행됩니다.

초기 테스트 버전부터 최종 릴리스 버전까지 애플리케이션을 릴리스할 때마다 lrelease 을 실행하세요. 애플리케이션을 실행하는 데 QM 파일이 필요하지는 않지만 사용 가능한 경우 애플리케이션이 이를 감지하여 자동으로 사용합니다.

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

릴리스 구문

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

Where:

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

참고: .pro 파일을 lrelease 으로 전달하는 것은 더 이상 사용되지 않습니다. qmake를 사용할 때는 lrelease-pro 도구 또는 lrelease.prf 기능을 사용하세요.

최신 도움말을 보려면 다음을 입력합니다:

lrelease -help

l해제 옵션

옵션동작
-help최신 도움말 정보를 표시하고 종료합니다.
-idbased메시지 키 입력에 소스 문자열 대신 ID를 사용합니다.
-compressQM 파일을 압축합니다.
-nounfinished미완성 번역은 포함하지 마세요.
-removeidentical번역된 텍스트가 소스 텍스트와 동일한 경우에는 메시지를 제외합니다.
-markuntranslated <prefix>메시지에 실제 번역이 없는 경우에는 대신 지정된 문자열이 접두사로 붙은 소스 텍스트를 사용합니다.
-project <filename>프로젝트의 설명이 JSON 형식으로 포함된 파일 이름입니다. lprodump 도구를 사용하여 .pro 파일에서 파일을 생성할 수 있습니다.
-silent수행 중인 작업을 설명하지 마세요.
-versionlrelease 버전을 표시하고 종료합니다.

예제

CMake와 함께 lrelease 사용

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

다음 옵션 중 하나를 선택합니다:

대상(예: app_lrelease)을 빌드하여 .qm 파일을 업데이트합니다. 모든 대상에 대한 .qm 파일을 업데이트하려면 release_translations 대상을 빌드합니다.

qmake와 함께 lrelease 사용

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

lrelease.exe main_en.ts languages\main_fr.ts

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