qt_add_lupdate

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() `를 사용하십시오. 이 명령어는 이 명령어와 동일한 인자 집합을 지원합니다.

설명

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 을 설정할 수 있습니다. 사용 가능한 옵션은 lupdate 문서에서 확인할 수 있습니다.

우산 타깃

${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 는 첫 번째 인수로 대상(target)을 받았습니다. 이 방식은 더 이상 사용되지 않습니다. 대신 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
)