【实习总结】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 里查找对应的译文,并显示译文而不是原文。

相关推荐
千里马-horse17 小时前
Async++ 源码分析3---cancel.h
开发语言·c++·async++·cancel
K_i13419 小时前
指针步长:C/C++内存操控的核心法则
java·开发语言
渡我白衣19 小时前
C++ :std::bind 还能用吗?它和 Lambda 有什么区别?
开发语言·c++·c++20
胖咕噜的稞达鸭19 小时前
算法入门:专题攻克主题一---双指针(1)移动零 复写零
c语言·开发语言·c++·算法
郝学胜-神的一滴19 小时前
Effective Python 第38条:简单的接口应该接受函数,而不是类的实例
开发语言·python·软件工程
一只小bit19 小时前
CMake 入门实战手册:从理解原理开始,打造高效 C/C++ 开发流程
c语言·开发语言·c++·cmake
青草地溪水旁19 小时前
设计模式(C++)详解——策略模式(1)
c++·设计模式·策略模式
secondyoung19 小时前
Markdown转换为Word:Pandoc模板使用指南
开发语言·经验分享·笔记·c#·编辑器·word·markdown
lly20240619 小时前
Django ORM - 聚合查询
开发语言
余衫马20 小时前
llama.cpp:本地大模型推理的高性能 C++ 框架
c++·人工智能·llm·llama·大模型部署