QT_ADD_LUPATE

Qt Linguist.ts 파일을 생성하거나 업데이트할 대상을 추가합니다.

이 명령은 Qt6 패키지의 LinguistTools 구성 요소에 정의되어 있습니다. 패키지를 로드합니다:

find_package(Qt6 REQUIRED COMPONENTS LinguistTools)

이 명령은 Qt 6.2에 도입되었습니다.

개요

6.7부터

qt_add_lupdate(TS_FILES file1.ts [file2.ts ...]
               [PLURALS_TS_FILE file.ts]
               [SOURCE_TARGETS target1 [target2 ...]]
               [SOURCES source1.cpp [sources2.cpp ...]]
               [INCLUDE_DIRECTORIES directory1 [directory2 ...]]
               [LUPDATE_TARGET target-name]
               [NO_GLOBAL_TARGET]
               [OPTIONS ...])

6.2부터(더 이상 사용되지 않음):

qt_add_lupdate(target TS_FILES file1.ts [file2.ts ...]
               [SOURCES source1.cpp [sources2.cpp ...]]
               [INCLUDE_DIRECTORIES directory1 [directory2 ...]]
               [NO_GLOBAL_TARGET]
               [OPTIONS ...])

버전 없는 명령이 비활성화되어 있으면 qt6_add_lupdate() 대신 사용하세요. 이 명령과 동일한 인자 집합을 지원합니다.

설명

업데이트가 포함된 Qt Linguist .ts 파일을 생성하거나 업데이트할 사용자 지정 대상을 만듭니다.

이 사용자 지정 대상의 기본 이름은 ${PROJECT_NAME}_lupdate 입니다. qt_add_lupdate 을 추가로 호출하면 숫자가 추가된 대상 이름이 만들어집니다. 사용자 지정 대상 이름은 LUPDATE_TARGET 옵션으로 지정할 수 있습니다.

SOURCE_TARGETS 인수를 사용하면 번역 가능한 문자열이 있는 소스를 포함하는 대상 목록을 지정할 수 있습니다. SOURCE_TARGETS 을 지정하지 않으면 아래에 설명된 SOURCES 을 지정할 수 있습니다. SOURCE_TARGETS 또는 SOURCES 을 지정하지 않으면 qt_collect_translation_source_targets 명령이 호출되어 대상 목록을 검색합니다.

.ts 파일은 TS_FILES 인수와 함께 지정해야 합니다.

이 함수는 qt_add_lrelease와 함께 사용하도록 설계되었습니다. 편의 래퍼인 qt_add_translations도 참조하십시오.

소스 및 인클루드 디렉터리

SOURCES 을 사용하면 번역 가능한 문자열이 포함된 추가 소스 파일을 명시적으로 지정할 수 있습니다.

INCLUDE_DIRECTORIES 을 사용하여 해당 소스 파일의 인클루드 디렉터리를 명시적으로 지정할 수 있습니다.

옵션

lupdate 호출 시 전달할 OPTIONS 을 추가로 설정할 수 있습니다. 가능한 옵션은 업데이트 문서에서 확인할 수 있습니다.

엄브렐러 대상

${target}_lupdate 대상 외에 엄브렐러 대상 update_translations 이 생성됩니다. 이 타깃은 qt_add_lupdate 으로 생성된 모든 ${target}_lupdate 타깃을 빌드합니다.

이 동작을 방지하려면 NO_GLOBAL_TARGET 을 qt_add_lupdate 으로 전달하세요.

이 대상의 이름은 qt_add_lupdate 을 호출하기 전에 QT_GLOBAL_LUPDATE_TARGET 변수를 설정하여 재정의할 수 있습니다.

복수형

QT_I18N_SOURCE_LANGUAGE는 소스 코드 문자열이 작성되는 언어를 지정합니다. 복수형을 올바르게 처리하려면 해당 언어에 대해 복수형에 대해 번역 가능한 문자열만 포함된 .ts 파일을 추가로 만드세요. 자세한 내용은 복수형 처리하기를 참조하세요.

PLURALS_TS_FILE 을 사용하여 소스 언어에 대한 .ts 파일을 지정할 수 있습니다. 이 파일에는 복수형만 포함됩니다.

사용되지 않는 명령 서명

이전 버전의 qt_add_lupdate 은 첫 번째 인수로 대상을 사용했습니다. 이는 더 이상 사용되지 않습니다. 대신 SOURCE_TARGETS 인수를 사용합니다.

예제

애플리케이션 myapp 의 .ts 파일을 업데이트하기 위해 myapp_lupdate 및 update_translations 대상을 추가합니다.

qt_add_lupdate(
    SOURCE_TARGETS myapp
    TS_FILES myapp_de.ts
    PLURALS_TS_FILE myapp_en.ts
)

LUPDATE_TARGET 인수를 전달하여 생성된 대상의 이름을 지정할 수 있습니다:

qt_add_lupdate(
    LUPDATE_TARGET update_application_translations
    TS_FILES myapp_de.ts
    PLURALS_TS_FILE myapp_en.ts
)