Verwendung von lupdate Verwendung von lupdate-pro

Verwendung von lrelease

Das Befehlszeilentool „ lrelease “ erstellt aus TS-Dateien QM-Dateien. Das QM-Dateiformat ist ein kompaktes Binärformat, das von der lokalisierten Anwendung verwendet wird. Es ermöglicht eine extrem schnelle Suche nach Übersetzungen.

Bei der Kompilierung mit qmake geben Sie die zu verarbeitenden Dateien über die Befehlszeile oder in einer .pro-Datei an.

Beim Erstellen mit CMake verwenden Sie CMake-Befehle, um Ziele hinzuzufügen, die TS-Dateien erstellen oder aktualisieren und diese in QM-Dateien umwandeln. Das Tool „ lrelease “ wird mit den Optionen ausgeführt, die Sie den Befehlen beim Erstellen des Ziels übergeben.

Führen Sie „ lrelease “ immer dann aus, wenn Sie die Anwendung veröffentlichen möchten, von der ersten Testversion bis hin zur endgültigen Release-Version. Die Anwendung benötigt keine QM-Dateien, um ausgeführt zu werden. Sind diese jedoch verfügbar, erkennt die Anwendung sie und nutzt sie automatisch.

Hinweis: Das Tool „ lrelease “ berücksichtigt nur Übersetzungen, die Sie als abgeschlossen markieren. Andernfalls wird stattdessen der Originaltext verwendet.

lrelease-Syntax

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

Wo:

options steht für eine oder mehrere lrelease-Optionen.
project-file ist die Projektkonfigurationsdatei.
ts-files sind die TS-Dateien, die als Eingabe für die QM-Dateien verwendet werden sollen.
qm-file ist der Name der zu erzeugenden QM-Datei.

Hinweis: Die Übergabe von .pro-Dateien an „ lrelease “ ist veraltet. Verwenden Sie bei der Verwendung von qmake das Tool „ lrelease-pro “ oder die Funktion „ lrelease.prf “.

Um die aktuelle Hilfe anzuzeigen, geben Sie Folgendes ein:

lrelease -help

lrelease-Optionen

Option	Aktion
`-help`	Zeigt aktuelle Hilfeinformationen an und beendet das Programm.
`-idbased`	Veraltet. Das Flag wird nicht mehr benötigt und wird in einer zukünftigen Version entfernt. Es wurde verwendet, um die ID-basierte Übersetzung zu aktivieren.
`-compress`	Die QM-Dateien komprimieren.
`-nounfinished`	Unvollständige Übersetzungen nicht einbeziehen.
`-fail-on-invalid`	Abbruch, wenn Übersetzungen gefunden werden, die die folgenden Prüfungen nicht bestehen: Gültigkeitsprüfung der Tastenkombinationen Gültigkeitsprüfung der umgebenden Leerzeichen Gültigkeitsprüfung der abschließenden Satzzeichen Gültigkeitsprüfung der Platzhalter Weitere Informationen finden Sie in der Hilfe zu „ Qt Linguist “.
`-fail-on-unfinished`	Fehlermeldung ausgeben, wenn unvollständige Übersetzungen gefunden werden
`-removeidentical`	Wenn der übersetzte Text mit dem Quelltext übereinstimmt, die Meldung ausschließen.
`-markuntranslated <prefix>`	Wenn eine Meldung keine echte Übersetzung hat, verwende stattdessen den Quelltext mit der angegebenen Zeichenfolge als Präfix.
`-project <filename>`	Name einer Datei, die die Projektbeschreibung im JSON-Format enthält. Sie können `lupdate-pro -dump-json` verwenden, um die Datei aus einer .pro-Datei zu generieren.
`-silent`	Keine Erklärung der durchgeführten Aktion anzeigen.
`-verbose`	Erläutern, was gerade geschieht (Standard).
`-version`	Zeige die Version von `lrelease` an und beende das Programm.

Beispiele

Verwendung von „lrelease“ mit CMake

Wenn Sie mit CMake kompilieren, fügen Sie mithilfe von CMake-Befehlen Übersetzungen für die Ziele in die Datei „CMakeLists.txt“ ein und kompilieren Sie anschließend die Ziele.

Wählen Sie eine der folgenden Optionen aus:

Verwenden Sie `qt_add_translations` für ein Ziel, z. B. „app“. Dadurch werden `qt_add_lupdate ` und `qt_add_lrelease` aufgerufen.
Verwenden Sie „ qt_add_lrelease “ für ein Ziel.

Erstellen Sie ein Ziel (z. B. „ app_lrelease “), um die dazugehörigen .qm-Dateien zu aktualisieren. Um die .qm-Dateien für alle Ziele zu aktualisieren, erstellen Sie das Ziel „ release_translations “.

Verwendung von `lrelease` mit `qmake`

So führen Sie „ lrelease “ ohne Angabe einer Projektdatei aus:

lrelease.exe main_en.ts languages\main_fr.ts

Verwendung von „lupdate“ Verwendung von „lupdate-pro“

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