qt_add_lupdate

Fügt Ziele hinzu, um .ts-Dateien von „ Qt Linguist “ zu generieren oder zu aktualisieren.

Der Befehl ist in der Komponente „ LinguistTools “ des Pakets „ Qt6 “ definiert. Laden Sie das Paket mit:

find_package(Qt6 REQUIRED COMPONENTS LinguistTools)

Dieser Befehl wurde in Qt 6.2 eingeführt.

Übersicht

Seit 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 ...])

Seit 6.2 (veraltet):

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

Wenn versionlose Befehle deaktiviert sind, verwende stattdessen „ qt6_add_lupdate() “. Dieser Befehl unterstützt dieselben Argumente wie der vorliegende Befehl.

Beschreibung

Erstellt ein benutzerdefiniertes Ziel, um mit „lupdate“ die Dateien „ Qt Linguist “ und „ .ts “ zu generieren oder zu aktualisieren.

Der Name dieses benutzerdefinierten Ziels lautet standardmäßig „ ${PROJECT_NAME}_lupdate “. Bei weiteren Aufrufen von „ qt_add_lupdate “ werden Zielnamen mit einer fortlaufenden Nummer im Anhang erstellt. Der Name des benutzerdefinierten Ziels kann mit der Option „ LUPDATE_TARGET “ festgelegt werden.

Mit dem Argument „ SOURCE_TARGETS “ können Sie eine Liste von Zielen angeben, die Quellen mit übersetzbaren Zeichenfolgen enthalten. Wenn „ SOURCE_TARGETS “ nicht angegeben ist, können Sie „ SOURCES “ angeben, was im Folgenden beschrieben wird. Wenn weder „ SOURCE_TARGETS “ noch „ SOURCES “ angegeben ist, wird der Befehl „qt_collect_translation_source_targets()“ aufgerufen, um die Liste der Ziele abzurufen.

Die „ .ts “-Dateien müssen mit dem Argument „ TS_FILES “ angegeben werden.

Diese Funktion ist für die Verwendung in Verbindung mit qt_add_lrelease() vorgesehen. Siehe auch den Komfort-Wrapper qt_add_translations().

Quell- und Include-Verzeichnisse

Mit ` SOURCES ` können Sie zusätzliche Quelldateien, die übersetzbare Zeichenfolgen enthalten, explizit angeben.

Mit ` INCLUDE_DIRECTORIES ` können Sie Include-Verzeichnisse für diese Quelldateien explizit angeben.

Optionen

Sie können zusätzliche ` OPTIONS ` festlegen, die beim Aufruf von ` lupdate ` übergeben werden sollen. Mögliche Optionen finden Sie in der lupdate-Dokumentation.

Übergeordnetes Ziel

Zusätzlich zum Ziel „ ${target}_lupdate “ wird ein übergeordnetes Ziel „ update_translations “ erstellt. Dieses Ziel baut alle „ ${target}_lupdate “-Ziele, die mit „ qt_add_lupdate “ erstellt wurden.

Übergeben Sie „ NO_GLOBAL_TARGET “ an „ qt_add_lupdate “, um dieses Verhalten zu verhindern.

Der Name dieses Ziels kann überschrieben werden, indem die Variable „ QT_GLOBAL_LUPDATE_TARGET “ vor dem Aufruf von „ qt_add_lupdate “ gesetzt wird.

Pluralformen

QT_I18N_SOURCE_LANGUAGE gibt die Sprache an, in der die Zeichenfolgen im Quellcode geschrieben sind. Um Pluralformen korrekt zu behandeln, erstellen Sie für diese Sprache eine zusätzliche Datei „ .ts “, die ausschließlich übersetzbare Zeichenfolgen für Pluralformen enthält. Weitere Informationen finden Sie unter „Behandlung von Pluralformen “.

Mit „ PLURALS_TS_FILE “ können Sie die Datei „ .ts “ für die Quellsprache angeben. Diese Datei enthält ausschließlich Pluralformen.

Veraltete Befehlssignatur

Ältere Versionen von ` qt_add_lupdate ` nahmen ein Ziel als erstes Argument entgegen. Dies ist veraltet. Verwenden Sie stattdessen das Argument ` SOURCE_TARGETS `.

Beispiele

Fügen Sie die Ziele „ myapp_lupdate “ und „ update_translations “ hinzu, um die Datei „ .ts “ einer Anwendung myapp zu aktualisieren.

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

Sie können den Namen des erstellten Ziels festlegen, indem Sie das Argument ` LUPDATE_TARGET ` übergeben:

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