Qt Quick I18N

Génération de fichiers de traduction (TS et QM) pour une application Qt Quick.

Lorsque vous exécutez l'application d'exemple, le runtime QML charge automatiquement une traduction à partir du sous-répertoire i18n du répertoire qui contient le fichier .qml principal, en fonction de la langue du système.

Marquer un texte comme traduisible

Dans le fichier Main.qml, utilisez la commande qsTr pour marquer le texte de l'interface utilisateur comme traduisible :

        Text {
            text: qsTr("Hello")

Activation de la traduction

Dans le fichier main.cpp, utilisez la commande QQmlApplicationEngine pour charger automatiquement les fichiers de traduction à partir d'un sous-répertoire appelé i18n dans le répertoire qui contient le fichier QML principal :

#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);
    QQmlApplicationEngine engine;

Les noms des fichiers de traduction dans le sous-répertoire i18n doivent avoir le préfixe qml_. Par exemple, qml_en_AU.ts.

Création des fichiers de traduction

Ajoutez le module LinguistTools comme valeur de la commande find_package dans le fichier CMakeLists.txt:

find_package(Qt6 REQUIRED COMPONENTS Core Gui Quick Qml LinguistTools)

Définir les fichiers de traduction à générer dans la commande qt_add_translations:

qt_add_translations(qmli18n
    RESOURCE_PREFIX /qt/qml/Translated/i18n
    TS_FILE_BASE qml
    TS_FILE_DIR i18n
)

Construire l'application pour générer les fichiers TS et QM.

Note : Sur Android, assurez-vous d'inclure les fichiers QM en tant que ressources.

Ajout de traductions

Pour créer des traductions pour de nouvelles langues, copiez i18n/base.ts vers i18n/qml_<lang>.ts. Vous pouvez utiliser Qt Linguist pour traduire les chaînes de caractères.

Exemple de projet @ code.qt.io

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