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