qt_deploy_translations

Stellt Qt-Übersetzungen bereit, die von einer ausführbaren Datei benötigt werden.

Der Befehl ist in der Komponente Core des Pakets Qt6 definiert, das auf diese Weise geladen werden kann:

find_package(Qt6 REQUIRED COMPONENTS Core)

Im Gegensatz zu den meisten anderen CMake-Befehlen, die von Qt bereitgestellt werden, kann qt_deploy_translations() nur von einem Deployment-Skript aufgerufen werden. Es kann nicht direkt vom Projekt während der configure-Phase aufgerufen werden.

Dieser Befehl wurde in Qt 6.5 eingeführt.

Übersicht

qt_deploy_translations(
    [CATALOGS catalogs]
    [LOCALES locales]
    [LCONVERT lconvert_executable]
    [VERBOSE]
)

Beschreibung

Bei der Installation einer Anwendung kann es wünschenswert sein, auch die Übersetzungen zu installieren, die zu den verwendeten Qt-Modulen gehören. Der Befehl qt_deploy_translations sammelt die notwendigen .qm Dateien aus der Qt-Installation und kompiliert sie zu einer qt_${language}.qm Datei pro Sprache. Die .qm Dateien werden in QT_DEPLOY_TRANSLATIONS_DIR installiert.

Argumente

Das Argument LOCALES gibt an, für welche Sprachumgebungen die Übersetzungen bereitgestellt werden sollen. Dies ist eine Liste von Sprache/Region-Kombinationen, wie sie im Qt Linguist Handbuch für Übersetzer beschrieben sind. Beispiele für gültige Sprachumgebungen sind: de, pl, oder pt_BR.

Wenn LOCALES weggelassen wird, werden alle verfügbaren Sprachumgebungen eingesetzt.

Das Argument CATALOGS gibt eine Liste von Übersetzungskatalogen an, die eingesetzt werden sollen. Wenn dieses Argument weggelassen wird, werden alle Kataloge bereitgestellt, die zu einem beliebigen Qt-Modul gehören, das im Projekt über find_package verwendet wird.

Das Argument LCONVERT gibt die ausführbare Datei lconvert an, die zum Kombinieren der Kataloge verwendet wird. Standardmäßig wird die lconvert der Qt-Installation verwendet.

Für Debugging-Zwecke kann das Argument VERBOSE gesetzt werden, um Diagnosemeldungen einzuschalten.

Beispiel

Das folgende Beispiel stellt die dänischen und deutschen Übersetzungen der Qt-Bibliotheken bereit.

qt_deploy_translations(
    LOCALES da de
)