发帖 回复
返回列表
  • 2881阅读
  • 2回复

Qml组件化编程4-i18n动态国际化 [复制链接]

 上一主题 下一主题
离线dd759378563
新手上路
 
只看楼主 倒序阅读 楼主  发表于: 2019-05-18

简介

本文是《Qml组件化编程》系列文章的第四篇，涛哥将教大家，如何在Qml中实现动态国际化。
i18n 是 internationalization(国际化) 的首尾字符加中间的 18 个字符。随着产品越做越大，要推向国际的时候，国际化这一步
是必不可少的。i18n 的方案有很多，这里只讨论在Qt/Qml中的方案。
文章主要发布在涛哥的博客 和 知乎专栏-涛哥的Qt进阶之路。


效果预览

看一下最终效果

目前支持的语言包括：
  • 中文
  • 英文
  • 日文
  • 韩文
  • 法文
  • 俄文
  • 德文
  • 西班牙文
  • 葡萄牙文
  • 意大利文
  • 越南文
  • 阿拉伯文
(其中阿拉伯文是从右往左写的，qml默认的处理看起来不完全正确。
涛哥对阿拉伯也不是很熟，就不深入研究了。)


源码中输出中文

先说一下源码中输出中文的问题。
在文件本身的编码是utf-8的前提下，以下三种方式都可以直接输出中文。
qInfo() << u8"山有木兮木有枝，心悦君兮君不知。";    
qInfo() << QStringLiteral("黄河远上白云间，一片孤城万仞山。");  
qInfo() << QString::fromLocal8Bit("人生若只如初见，何事秋风悲画扇。");


u8是c++11标准支持的字符串字面量写法，可以参考https://zh.cppreference.com/w/cpp/language/string_literal
QStringLiteral是Qt特有的宏，用来在编译期生成字符串字面量，效果和u8类似。
QString::fromLocal8Bit可以在运行过程中，动态处理中文字符串。


（题外话：有一部分人给涛哥提过 “源码中不该写中文，应该全部做进翻译文件”的思想，但是涛哥在实践中发现这个思想并不能很好地执行。
一方面并没有编译器之类的约束，另一方面也不方便。
涛哥这里提出反问：文件本身是utf8的，utf8就是支持中文的，凭啥就不能写中文了？再者说，我翻译的目标语言正确了，翻译源文是什么语言又有什么关系呢？
俄罗斯人代码写的挺好的，github上就有不少带俄文注释的代码)


Qt本身的国际化

Qt的国际化, 相关文章太多了，Qt帮助文档也有，涛哥这里列出重点
  1. C++代码中的字符串使用QObject::tr()包起来，类本身是QObject的子类时可以省略作用域“QObject::”,直接写tr
  2. qml代码中使用qsTr把字符串包起来
  3. pro文件中添加一句TRANSLATIONS += trans_zh.qs ，这个名字起什么无所谓，关键是‘_zh’要有。
  4. 调用lrelease工具,扫描项目并生成trans_zh.qs 文件。这个文件是xml格式的，未经过翻译的，需要为这个文件做一些翻译工作。 后面说怎么做翻译。
  5. 翻译做好后，调用lupdate工具，生成trans_zh.qm文件。这个文件就是把xml变成了二进制。
  6. 将qm文件放在运行路径，或者资源文件里。
  7. 切换语言时， Qt/C++代码中使用QTranslater加载qm文件，QCoreApplication卸载旧的QTranslater，并安装新的QTranslater。调用 QmlEngine::retranslate函数
在5.10以前的版本，Qt是不能直接动态切换语言的，要么重新启动程序，要么把所有的text都set一遍，retranslate是5.10才有的接口。
涛哥这次的方案，以retranslate为主，5.10以前还有各路大神的动态切换语言方案，不在本次文章的讨论范围。


翻译工作

Qt提供了可视化的工具，即QTDIR/bin路径下的linguist.exe，可以直接打开我们拿到的trans_zh.qs文件。这个工具可以由程序员之外不懂xml的专业翻译人士使用。
涛哥在这里就使用自动化的翻译工具来做这个事情，比如使用 百度翻译API 或 有道翻译API。
为此，涛哥使用go语言写了一个小工具，能接入百度和有道的翻译API，并且能读取Qt的qs文件、完成翻译后再写回qs文件。
小工具已经开源 Qt-Transer
当然这种小工具Qt也能做，涛哥使用go纯属兴趣。


实现动态翻译



加载翻译文件

需要在Qt/C++代码中实现，并提供给qml调用。这里以中文和英文为例，涛哥直接写在了自定义QQuivkView的代码里。
复制代码
  1. //TaoView.h
  3. class TaoView : public QQuickView
  4. {
  5.     Q_OBJECT
  6. public:
  7.     explicit TaoView(QWindow *parent = nullptr);
  8.     Q_INVOKABLE void reTrans(const QString &lang);  //这是通过invokable导出的函数
  10. public slots:
  11. private:
  12.     QTranslator m_enTrans;      //英文的翻译
  13.     QTranslator m_zhTrans;      //中文的翻译
  14.     QString m_lang;             //记录当前语言
  15. };

复制代码
  1. // TaoView.cpp
  2. #include "stdafx.h"
  4. #include "TaoView.h"
  6. #include <QTranslator>
  7. #include <QQmlEngine>
  8. TaoView::TaoView(QWindow *parent) : QQuickView(parent)
  9. {
  10.     setFlag(Qt::FramelessWindowHint);
  11.     setResizeMode(SizeRootObjectToView);
  12.     setColor(QColor(Qt::transparent));
  13.     
  14.     //构造函数直接加载翻译文件
  16.     bool ok = m_enTrans.load("trans_en.qm");
  17.     bool ok2 = m_zhTrans.load("trans_zh.qm");
  18.     qWarning() << ok << ok2;
  20.     //默认安装中文
  21.     QCoreApplication::installTranslator(&m_zhTrans);
  22.     m_lang = QStringLiteral("中文简体");
  23. }
  25. void TaoView::reTrans(const QString &lang)
  26. {
  27.     if (m_lang == lang)
  28.     {
  29.         return;
  30.     }
  31.     //切换语言
  32.     m_lang = lang;
  33.     if ( lang == QStringLiteral("中文简体"))
  34.     {
  35.         QCoreApplication::removeTranslator(&m_enTrans);
  36.         QCoreApplication::installTranslator(&m_zhTrans);
  37.         engine()->retranslate();
  38.     } else if (lang == "English") {
  39.         QCoreApplication::removeTranslator(&m_zhTrans);
  40.         QCoreApplication::installTranslator(&m_enTrans);
  41.         engine()->retranslate();
  42.     }
  43. }



Qml中切换语言

和文章3 Qml组件化编程3-动态切换皮肤 类似, 在标题栏按钮中做一个切换按钮
复制代码
  1. // TitleBar.qml
  2. TImageBtn {
  3.     width: 20
  4.     height: 20
  5.     anchors.verticalCenter: parent.verticalCenter
  6.     imageUrl: containsMouse ? "qrc:/Image/Window/lang_white.png" : "qrc:/Image/Window/lang_gray.png"
  7.     onClicked: {
  8.         pop.show()
  9.     }
  10.     TPopup {
  11.         id: pop
  12.         barColor: gConfig.reserverColor
  13.         backgroundWidth: 100
  14.         backgroundHeight: 80
  15.         contentItem: ListView {
  16.             id: langListView
  17.             anchors.fill: parent
  18.             anchors.margins: 2
  19.             model: ["中文简体", "English"]      //语言列表，这里不需要qsTr
  20.             delegate: TTextBtn {
  21.                 width: langListView.width
  22.                 height: 36
  23.                 text: modelData
  24.                 color: containsMouse ? "lightgray" : pop.barColor
  25.                 onClicked: {
  26.                     pop.hide()
  27.                     //调用Q_INVOKABLE导出的函数，reTrans
  28.                     view.reTrans(modelData)
  29.                 }
  30.             }
  31.         }
  32.     }
  33. }



多国语言版本

前面的代码只有中文和英文，已经可以说明问题了。
这里再把最终版本的多国语言的贴出来。
这是头文件
复制代码
  1. //TaoView.h
  2. #pragma once
  4. #include <QQuickView>
  5. #include <memory>
  7. class TaoView : public QQuickView
  8. {
  9.     Q_OBJECT
  10.     Q_PROPERTY(QStringList languageList READ languageList NOTIFY languageListChanged)
  11. public:
  12.     explicit TaoView(QWindow *parent = nullptr);
  13.     Q_INVOKABLE void reTrans(const QString &lang);
  14.     const QStringList &languageList() const
  15.     {
  16.         return m_languageList;
  17.     }
  19. signals:
  20.     void reTransed();
  21.     void languageListChanged();
  23. private:
  24.     QString m_lang;
  25.     QMap<QString, std::shared_ptr<QTranslator>> m_transMap;
  26.     QTranslator *m_pLastLang = nullptr;
  27.     QStringList m_languageList;
  28. };





这是cpp
复制代码
  1. //TaoView.cpp
  2. #include "stdafx.h"
  4. #include "TaoView.h"
  6. #include <QTranslator>
  7. #include <QQmlEngine>
  8. TaoView::TaoView(QWindow *parent) : QQuickView(parent)
  9. {
  10.     setFlag(Qt::FramelessWindowHint);
  11.     setResizeMode(SizeRootObjectToView);
  12.     setColor(QColor(Qt::transparent));
  14.     m_languageList << u8"中文简体"
  15.                    << u8"English"
  16.                    << u8"日本語"
  17.                    << u8"한국어"
  18.                    << u8"Français"
  19.                    << u8"Español"
  20.                    << u8"Portugués"
  21.                    << u8"In Italiano"
  22.                    << u8"русский язык"
  23.                    << u8"Tiếng Việt"
  24.                    << u8"Deutsch"
  25.                    << u8" عربي ، ";
  26.     QStringList fileList;
  27.     fileList << "trans_zh.qm"
  28.             << "trans_en.qm"
  29.             << "trans_ja.qm"
  30.             << "trans_ko.qm"
  31.             << "trans_fr.qm"
  32.             << "trans_es.qm"
  33.             << "trans_pt.qm"
  34.             << "trans_it.qm"
  35.             << "trans_ru.qm"
  36.             << "trans_vi.qm"
  37.             << "trans_de.qm"
  38.             << "trans_ar.qm";
  40.     for (auto i = 0; i < m_languageList.length(); ++i)
  41.     {
  42.         auto trans = std::make_shared<QTranslator>();
  43.         bool ok = trans->load(fileList.at(i));
  44.         qWarning() << m_languageList.at(i) << fileList.at(i) << ok;
  45.         m_transMap[m_languageList.at(i)] = trans;
  46.     }
  47.     m_pLastLang = m_transMap[m_languageList.at(0)].get();
  48.     QCoreApplication::installTranslator(m_pLastLang);
  49.     m_lang = m_languageList.at(0);
  50.     emit languageListChanged();
  51. }
  53. void TaoView::reTrans(const QString &lang)
  54. {
  55.     if (m_lang == lang)
  56.     {
  57.         return;
  58.     }
  59.     m_lang = lang;
  61.     QCoreApplication::removeTranslator(m_pLastLang);
  62.     m_pLastLang = m_transMap[lang].get();
  63.     QCoreApplication::installTranslator(m_pLastLang);
  64.     engine()->retranslate();
  65.     emit reTransed();
  66. }





还有qml
  
复制代码
  1. ....
  2.         TImageBtn {
  3.             width: 20
  4.             height: 20
  5.             anchors.verticalCenter: parent.verticalCenter
  6.             imageUrl: containsMouse ? "qrc:/Image/Window/lang_white.png" : "qrc:/Image/Window/lang_gray.png"
  7.             onClicked: {
  8.                 pop.show()
  9.             }
  10.             TPopup {
  11.                 id: pop
  12.                 barColor: gConfig.reserverColor
  13.                 backgroundWidth: 100
  14.                 backgroundHeight: 400
  15.                 contentItem: ListView {
  16.                     id: langListView
  17.                     anchors.fill: parent
  18.                     anchors.margins: 2
  19.                     model: view.languageList        //这里换成了list属性
  20.                     delegate: TTextBtn {
  21.                         width: langListView.width
  22.                         height: 36
  23.                         text: modelData
  24.                         color: containsMouse ? "lightgray" : pop.barColor
  25.                         onClicked: {
  26.                             pop.hide()
  27.                             view.reTrans(modelData)
  28.                         }
  29.                     }
  30.                 }
  31.             }
  32.         }
  33.     ....



转载声明

文章出自涛哥的博客 – 点击这里查看涛哥的博客文章采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可, 转载请注明出处, 谢谢合作 © 涛哥
涛哥是个Qml高手，著有《Qml组件化编程》《Qml特效》系列教程，见知乎专栏-Qt进阶之路：https://zhuanlan.zhihu.com/TaoQt
或微信公众号：Qt进阶之路
回复
举报
分享到 淘江湖 新浪 QQ微博 QQ空间 开心 人人 豆瓣 网易微博 百度 鲜果 白社会 飞信
离线yysr
新手上路
只看该作者 1楼 发表于: 2019-05-19
回复
举报
离线big_mouse
禁止发言
只看该作者 2楼 发表于: 2020-04-15
回复
举报
发帖 回复
返回列表
快速回复
限100 字节
 
上一个 下一个