【实习总结】Qt通过Qt Linguist(语言家)实现多语言支持

目录

技术背景

核心概念

具体步骤

第一步:标记需要翻译文本

第二步:配置项目文件(.pro)

第三步:运行lupdate生成.ts文件

[第四步:翻译人员通过Qt 语言家翻译文本](#第四步:翻译人员通过Qt 语言家翻译文本)

[第五步: 运行lrelease生成.qm文件](#第五步: 运行lrelease生成.qm文件)

第六步:在程序中加载.qm文件


技术背景

当我们使用Qt开发软件,需要支持多语言切换,以此来实现软件国际化,在介绍之前,我们需要了解下如果没有qt语言家,我们会怎么实现多语言的。

比如在MFC中,通过在定于多个xml文件(每个语言一个xml文件),在xml文件中,为每一个需要支持多语言的字符串定义一个唯一的、固定的ID,并写上对应语言的文本,如下:

XML 复制代码
<Dlg DlgId="25010">
    <IDS ID="1" String="确定" />
    <IDS ID="2" String="取消" />
</Dlg>

然后在程序启动或切换语言的时候,根据选择的语言,读取并解析对应的xml文件。此时Qt Linguist提供的是一个 完整、成熟、工业级的国际化解决方案 ,而不仅仅是一个文件格式。它通过强大的工具链将繁琐、易错的手动操作自动化。

核心概念

在开始具体步骤的介绍之前,我们需要认识一下几个核心文件和工具。

1、tr()函数

这是我们需要在代码中使用的函数,用来标记所有需要被翻译的文本,他就像一个记号,告诉qt,这个文本是需要替换成其他语言的。

2、.pro文件

Qt项目的配置文件,我们需要在这里告诉Qt,我们的项目需要支持哪些语言。

3、.ts文件

这是一个基于XML格式的翻译源软件,它由Qt的工具生成,里面包含了所有被tr()函数标记过的原始文本,这个文件是给翻译人员使用的,他们用Qt Linguist工具打开它,然后逐条译文。

4、.qm文件

这是一个已编译的、二进制格式的翻译软件,它是由.ts文件发布生成的,体积更小,速度更快,这个文件是给程序在运行的时候使用的,程序会加载它来查找并显示翻译后的文本

5、lupdate工具

一个命令行工具,他的作用是扫描源代码(.cpp,.h,.ui文件),找出所有被tr()函数标记的字符串,然后生成或更新.ts文件

6、Qt Linguist工具

一个图形界面的翻译软件,翻译人员用它来打开.ts文件,然后方便填写译文。

7、lrelease工具

另一个命令行工具,它的作用是将已经翻译好的.ts文件转换成程序最终使用的二进制.qm文件。

具体步骤

第一步:标记需要翻译文本

我们需要在代码中标记待翻译的字符串,这是最基础也是最重要的一步,需要使用到上面所介绍的tr()函数,如下:

cpp 复制代码
QLabel *label = new QLabel(tr("Hello World"));
QPushButton *button = new QPushButton(tr("Submit"));

第二步:配置项目文件(.pro)

在标记完待翻译的字符串之后,我们需要告诉Qt,项目需要哪些目标语言,这样lupdate工具会根据这个配置来生成相应语言的.ts文件.

那么要怎么配置.pro文件呢?

如下,在.pro文件中添加一个TRANSLATIONS变量,列出所有需要的.ts文件

cpp 复制代码
TRANSLATIONS = \
    language_zh_CN.ts \
    language_fr.ts

这里的ts文件名可以自定义的,但通常需要包含语言简写以便区分。

第三步:运行lupdate生成.ts文件

现在,让lupdate工具自动为我们创建翻译源文件,省去了我们手动创建待翻译文本的XML文件的步骤。

执行完之后,我们在项目目录下便可以看到添加的.ts文件 。

第四步:翻译人员通过Qt 语言家翻译文本

先点击文件->打开文件

选择要进行翻译的语言对应的.ts文件

使用Qt Linguist打开

Qt Linguist提供一个非常友好的界面,他会逐条显示原文,我们只需要再旁边的输入框里填入译

即可,如下

在条框输入译文之后,可以点击工具栏上的"对号"图标(或者按Ctrl+Enter)确认该条翻译完成,如下

第五步: 运行lrelease生成.qm文件

翻译工作完成后,我们需要将.ts文件转换成程序能高效使用的格式。因为.ts文件是xml格式,方便我们阅读和编辑,但是解析慢,体积大。.qm是紧凑的二进制格式,程序加载和查找速度极快,适合在运行中使用,可以减小应用的体积和提高速度。

步骤:在Qt Creator中,点击菜单栏的 "工具" -> "外部" -> "Linguist" -> "发布翻译(lrelease)" 。

执行后,每个.ts文件旁边都会生成一个同名的.qm文件 。

第六步:在程序中加载.qm文件

程序本身不会自动加载翻译文件,我们必须在代码中告诉程序,现在用户选择了什么语言,请加载对应的.qm文件,并进行替换。

cpp 复制代码
#include "mainwindow.h"
#include <QApplication>
#include <QTranslator>   // 1. 包含头文件
#include <QLocale>       // 用于获取系统语言

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    // 2. 创建翻译家对象
    QTranslator translator;

    // 3. 根据当前系统语言加载对应的.qm文件
    // 这里假设.qm文件和可执行文件在同一目录下的i18n文件夹中
    // 或者你也可以使用Qt资源系统(.qrc)来将.qm文件编译到程序内部
    QString lang = QLocale::system().name(); // 例如 "zh_CN"
    if (translator.load(":/i18n/language_" + lang)) { // 从资源文件加载
        // 4. 安装翻译家到应用程序
        a.installTranslator(&translator);
    }

    MainWindow w;
    w.show();

    return a.exec();
}

当翻译家对象成功加载了翻译文件,这里的a.installTranslator(&translator)就是将这个translator安装到整个应用程序a中,一旦安装成功,Qt 的事件循环就会自动拦截所有需要显示文本的地方(比如 QLabel 的文本、 QPushButton 的按钮名等),如果这些文本被 tr() 函数标记过,Qt 就会拿着原文去 translator 里查找对应的译文,并显示译文而不是原文。

相关推荐
叉烧钵钵鸡18 分钟前
Java ++i 与 i++ 底层原理
java·开发语言·后端
御水流红叶33 分钟前
安卓加固脱壳
android·开发语言·python
hqxstudying35 分钟前
SpringAI的使用
java·开发语言·人工智能·springai
狐小粟同学36 分钟前
JAVAEE--4.多线程案例
java·开发语言
the beard1 小时前
RabbitMQ:基于SpringAMQP声明队列与交换机并配置消息转换器(三)
java·开发语言·rabbitmq·intellij idea
清朝牢弟1 小时前
Ubuntu系统VScode实现opencv(c++)视频的处理与保存
c++·人工智能·vscode·opencv·ubuntu
oioihoii2 小时前
在macOS上使用VS Code和Clang配置C++开发环境
c++·macos·策略模式
Warren982 小时前
Java泛型
java·开发语言·windows·笔记·python·spring·maven
仪器科学与传感技术博士2 小时前
python:以支持向量机(SVM)为例,通过调整正则化参数C和核函数类型来控制欠拟合和过拟合
开发语言·python·算法·机器学习·支持向量机·过拟合·欠拟合
科大饭桶2 小时前
C++入门自学Day5-- C/C++内存管理(续)
c语言·开发语言·c++