Qt/C++ Tutorial 092. Übersetzungen für externe Textquellen erstellen

Qt 6, Qt, Qt 5, QtLinguist, translation

Heute werden wir eine ziemlich interessante Option zum Hinzufügen einer Übersetzung zu einer Qt/C++ - Anwendung diskutieren. Nämlich das Hinzufügen von Übersetzungen für Texte aus externen Quellen, wenn Sie Texte aus Datenbanken, einer externen API oder nur einigen anderen Dateien anzeigen.

Eine solche Situation kann beispielsweise in folgendem Fall auftreten, wenn Analysten in Ihrem Projekt Datensätze und Texte in einer externen Datenbank oder Textdatei bilden, aber aus irgendeinem Grund keine Möglichkeit der Mehrsprachigkeit besteht. Daher haben Sie bei der Abfrage dieser Daten nicht die Möglichkeit, die Sprache als zusätzlichen Parameter auszuwählen. Oder die endgültigen Daten werden beispielsweise von einer externen Ressource heruntergeladen und in einer SQLite-Datenbank gespeichert, natürlich ohne zusätzliche Übersetzungen. Aber gleichzeitig entwickeln Sie eine mehrsprachige Anwendung und müssen irgendwie Übersetzungsdateien für diese Texte generieren, damit das Übersetzungsteam sie übersetzen kann, und Sie können sie in der Anwendung verbinden.

Aber in Qt ist es auch möglich, dieses Problem zu lösen. In solchen Situationen können Sie auf die gleiche Weise auch Quellcodedateien generieren, z. B. beim Importieren von Daten während der Anwendungsentwicklung, und dann Übersetzungsdateien mit der Erweiterung *.ts generieren, die in QtLinguist verwendet werden um die Anwendung in Qt zu übersetzen und dann binäre *.qm Übersetzungsdateien zu generieren, die in die Anwendung aufgenommen werden.

Mal sehen, wie es funktioniert und was dafür getan werden muss.

Quelldateien hinzufügen

Damit die lupdate -Anwendung *.ts -Dateien erstellen kann, muss das Projekt über Header- und Quelldateien verfügen. Sie müssen aber nicht kompiliert werden. Es stellt sich als ein so interessanter Trick heraus, bei dem es nicht kompilierte Dateien im Projekt gibt, aber ohne sie ist es nicht möglich, *.ts -Dateien zu generieren.

pro-Dateien

Schauen wir uns den Inhalt der Profildatei an, um zu verstehen, welche Dateien in unserem Projekt benötigt werden.

TRANSLATIONS = myapp_en.ts \
               myapp_cs.ts \
               myapp_de.ts \
               myapp_es.ts

SOURCES += \
    translations_generated.cpp

HEADERS += \
    translations_generated.h

Wie Sie sehen können, gibt es *.ts -Übersetzungsdateien sowie zwei Dateien translations_generated.h und translations_generated.cpp .
Diese Dateien werden von Ihnen manuell generiert oder hinzugefügt, es spielt keine Rolle, es spielt keine Rolle, wie genau Sie diese Dateien erstellen und hinzufügen.
Die Hauptsache ist, dass diese Dateien einen angemessenen Inhalt haben.

translations_generated.h

Sie werden überrascht sein, aber wir lassen diese Datei leer.

translations_generated.cpp

Und hier die wichtigsten Inhalte.

#ifdef TRANSLATOR_GUARD

//
// Uncompiled file, only as source for lupdate.exe
//
namespace my
{
namespace translation
{
namespace example
{
Q_OBJECT
tr("Height");
tr("Total length");
tr("Length");
tr("Home");
} // namespace my
} // namespace translation
} // namespace example

#endif // TRANSLATOR_GUARD

Beachten Sie einige wichtige Dinge zu dieser Datei:

• TRANSLATOR_GUARD - was verhindert, dass die Datei kompiliert wird, wir brauchen es nicht
• namespace - Namensräume erstellen den Kontext, in dem die Übersetzung generiert wird. In diesem Fall lautet der Kontext "my::translation::example"
• Q_OBJECT - dieses Makro teilt lupdate mit, dass es hier Übersetzungsaufruffunktionen geben kann, mit deren Hilfe die Übersetzungsdatei erzeugt wird.

Nachdem Sie die Übersetzungsdateien mit dem Programm lupdate generiert haben, können Sie diese Zeichenfolgen in QtLinguist übersetzen und dann die binären Übersetzungsdateien kompilieren, die in Ihrer Anwendung korrekt verwendet werden.

Übersetzungen verwenden

Die Verwendung der Übersetzung unterscheidet sich darin, dass Sie keinen bestimmten Text schreiben, sondern eine Variable und einen Kontext an die Übersetzungsfunktion QCoreApplication::translate übergeben.

Mal sehen, wie es mit einer Beispielklasse aussehen würde. Diese Klasse hat eine Variable, die den zu übersetzenden String enthält, sowie eine Methode zur Rückgabe des übersetzten Werts.

#include <QCoreApplication>
#include <QString>

class ExampleTranslator
{
public:
    QString getTranslatedName() const
    {
        return QCoreApplication::translate("my::translation::example", m_name.toUtf8());
    }

private:
    QString m_name;
}

Die QCoreApplication::translate -Methode versucht bei einem ordnungsgemäß aufgerufenen Kontext, eine Übersetzung für den übergebenen Text zu finden, und gibt bei Erfolg den übersetzten Wert für die aktive Sprache in der Anwendung zurück.

Fazit

Damit ist es möglich, Übersetzungen beliebiger externer Texte auch mit Standard-Qt-Tools durchzuführen.