本文还有配套的精品资源，点击获取 menu-r.4af5f7ec.gif

简介：在软件开发中，为满足不同语言用户需求，多语言支持至关重要。本示例展示了如何利用Visual Studio和Qt框架实现在应用程序中轻松切换中英文界面。通过Qt框架的国际化支持，包括使用QTranslator类和.qm文件，我们创建了简体中文和英文版本的翻译文件，并通过编程实现了从一种语言切换到另一种语言的界面。本文详细介绍了创建翻译文件、集成到项目、加载和应用翻译、事件处理、重新绘制界面以及测试与调试的整个流程，为开发者提供了一个中英文界面切换的实用案例，帮助他们更好地实现软件的本地化。
vs+Qt 实现版本中英文切换

1. 多语言支持的重要性

在当今全球化的商业环境中，软件产品的多语言支持已成为一项不可或缺的功能。它不仅能够帮助企业拓展海外市场，满足不同语言用户的使用需求，而且还是国际化与本地化策略的重要组成部分。多语言支持有利于提升用户体验，增加产品的亲和力和市场竞争力。本章将深入探讨为何多语言支持对于软件产品的成功至关重要，并概述实现多语言支持的多种方法和最佳实践。

  • 软件国际化（Internationalization，简称i18n）允许软件无需修改代码即可支持多种语言，从而增加市场覆盖率。
  • 本地化（Localization，简称l10n）是指将软件产品转换成特定地区语言的过程。
  • 多语言支持的实现要求软件架构能够处理不同字符编码、布局和文化差异，同时考虑到性能、资源管理和维护成本。

1.1 多语言支持与市场扩张

当企业考虑国际市场时，本地化的软件可以更好地与目标市场沟通。由于文化和语言的差异，非本地化软件可能会忽视重要的市场细节，导致用户体验不佳。

1.2 代码的可维护性与升级

支持多语言的软件代码应当是可扩展和可维护的，这样在添加新语言支持时，才能最小化代码修改和维护的复杂度，从而节省成本。

1.3 用户体验的提升

良好的多语言支持直接关系到用户的使用体验。用户更倾向于使用自己的母语进行交流，这对于提升用户的满意度和忠诚度至关重要。

2. Qt国际化(i18n)框架介绍

2.1 Qt国际化框架基础

2.1.1 国际化框架的设计理念

国际化（Internationalization）在软件开发中通常缩写为 i18n，因为它涉及到的词语“internationalization”从第一个字母“i”到倒数第二个字母“n”之间有18个字母。在Qt框架中，国际化是通过一系列的工具和类库来实现的，让应用能够支持不同的语言和地区设置。

Qt的国际化框架主要设计理念是通过一套标准的API，将应用中所有的字符串内容与代码逻辑分离开来。这种分离使得翻译人员可以在不影响程序执行逻辑的情况下，对应用中的文本进行翻译。

此外，Qt的国际化框架还设计为易于扩展和维护，支持从右到左的语言（如阿拉伯语和希伯来语），并且提供了自动格式化本地日期、时间和数字的功能。

2.1.2 核心组件及工作流程

Qt国际化框架的核心组件包括：

  • QLocale ：管理地区相关的设置，比如日期、时间、数字格式等。
  • QTranslator ：翻译器组件，用于加载 .qm 翻译文件，并提供翻译文本。
  • QCoreApplication::installTranslator() ：安装翻译器到应用中的方法。
  • QObject::tr() 和 QObject::trUtf8() ：用于标记需要翻译的字符串。

工作流程大致如下：

  1. 使用 QObject::tr() 对需要国际化的字符串进行标记。
  2. 利用 lupdate 工具，从源代码中提取待翻译的字符串到 .ts 文件。
  3. 翻译 .ts 文件中的字符串内容，并使用 lrelease 工具将 .ts 文件编译成 .qm 文件。
  4. 在程序运行时，使用 QTranslator 加载 .qm 文件，并通过 installTranslator() 方法将翻译器对象安装到 QCoreApplication 中。
  5. 当需要显示翻译文本时， tr() 方法会使用翻译器来查找并返回翻译后的字符串。

2.2 Qt国际化框架的扩展

2.2.1 对其他语言的支持情况

Qt框架支持超过300种语言，具有良好的国际化支持。除了基本的字符集支持之外，Qt还提供了对Unicode的全面支持，这意味着它能够处理所有现代脚本以及历史和人工创造的书写系统。

对于特别的文本布局需求，比如从右到左的语言（例如阿拉伯语、希伯来语），Qt框架也提供了完整的支持。文本布局、文本输入和显示、以及与文本相关的控件都已经为这些特殊需求进行了适配。

2.2.2 框架的可定制性分析

Qt的国际化框架是高度可定制的。开发者可以根据需要，实现自己的翻译管理器或适配器，从而集成第三方翻译服务或实现特定的翻译流程。

此外，Qt还提供了 QTranslator 的派生类接口，允许开发者扩展或修改翻译的查找和替换逻辑。这使得开发者可以在底层定制翻译行为，例如添加翻译文件的加密机制、增加翻译验证步骤或实现更复杂的翻译选择逻辑。

2.2.2.1 自定义翻译器

#include <QTranslator>

class MyTranslator : public QTranslator {
public:
    bool translate(const QString &context, const QString &sourceText, QString *translatedText,
                   int n, QAbstractMessageHandler *handler) const override {
        // 自定义翻译逻辑
        *translatedText = customTranslateFunction(sourceText);
        return !sourceText.isEmpty();
    }
private:
    QString customTranslateFunction(const QString &sourceText) {
        // 实现一个自定义的翻译函数
        // ...
    }
};

在上述代码示例中，我们创建了一个自定义的翻译器类 MyTranslator ，并重写了 translate 方法。这允许我们使用自定义的翻译函数 customTranslateFunction 来处理翻译逻辑。这样的定制化扩展，为应用提供了更多的灵活性和控制能力。

在实际应用中，开发者可以将这个自定义的翻译器安装到 QCoreApplication 中，并像使用标准 QTranslator 一样进行操作。这种方式适用于需要特殊处理或额外逻辑的翻译需求。

2.2.2.2 嵌入式系统的国际化

在嵌入式系统或资源受限的环境中，可能无法使用 .qm 文件或存储完整翻译内容。在这种情况下，可以考虑将翻译数据直接嵌入到二进制文件中，并通过自定义的翻译器逻辑进行访问。

#include <QTranslator>
#include <QObject>

class EmbeddedTranslator : public QTranslator {
    Q_OBJECT
public:
    EmbeddedTranslator(QObject *parent = nullptr) : QTranslator(parent) {
        // 预先加载翻译数据
        // ...
    }

    bool load() override {
        // 覆盖QTranslator的load方法
        // ...
        return true;
    }

    const char *translate(const char *context, const char *sourceText, const char *disambiguation,
                          int n) const override {
        // 实现翻译查找逻辑，从嵌入数据中获取翻译结果
        // ...
    }
};

#include "main.moc"

通过这种方式，开发者可以创建一个嵌入式特定的翻译器，并将其安装到 QCoreApplication 。这使得应用能够在不依赖外部文件的情况下，支持多种语言。

这种做法的一个限制是，每次添加新语言或更新翻译时，都需要重新编译程序。因此，这种定制化的翻译策略更适合那些翻译内容相对固定、更新频率不高的场景。

3. .qm文件的作用与处理

3.1 .qm文件的基本概念

3.1.1 .qm文件的格式与内容

QM文件是Qt国际化（i18n）框架中的一种二进制文件格式，用于存储翻译后的文本数据。QM文件格式是基于二进制的，由Qt提供工具自动生成，主要包含键值对映射关系，其中键对应源代码中的原文本（上下文），值对应翻译后的文本。QM文件的内容主要由以下几个部分组成：

  • 文件头：包含QM文件的元数据，比如版本号、格式标识等信息。
  • 翻译数据：由键值对组成，其中键为源文本的标识符，值为对应的翻译文本。
  • 编码信息：为确保翻译文本在不同语言环境中的正确显示，QM文件中还会包含编码格式信息。
  • 其他可能包含的元数据：例如翻译完成的时间戳、翻译者的标识等。

3.1.2 .qm文件与源语言文件的关系

QM文件是基于源语言文件（通常为源代码中的字符串资源文件）生成的，它并不直接包含源代码，而是存储了翻译后的文本。QM文件的生成依赖于源语言文件中的翻译标记，这包括使用 qsTr 、 qsTranslate 等宏函数标记的需要翻译的字符串。生成QM文件后，应用程序在运行时可以加载QM文件，并通过查找键值对的方式来展示翻译后的文本。这种机制使得同一个应用程序可以在不同语言环境下运行，而无需修改程序源代码。

3.2 .qm文件的生成与管理

3.2.1 生成.qm文件的工具介绍

生成QM文件的工具有Qt自带的 lupdate 工具和 Qt Linguist 软件。 lupdate 用于从源代码文件中提取翻译文本并生成一个 .ts （翻译源）文件，这个过程可以自动化，并且可以持续集成到项目的构建过程中。之后，可以使用 lrelease 工具将 .ts 文件转换为 .qm 文件。

lupdate main.cpp -ts translations.ts
lrelease translations.ts -qm translations.qm

3.2.2 qm文件的版本控制与更新策略

QM文件应该与版本控制系统一起管理。每次更新源语言文件后，应该重新生成QM文件并提交到版本控制系统中。为了保持历史数据的完整性和可追溯性，旧的QM文件应该保留，而创建新的QM文件，例如 translations_v2.qm 。在软件部署时，应该根据软件版本选择正确的QM文件。

更新策略可以包括以下步骤：

  1. 当添加或修改了需要翻译的文本时，使用 lupdate 重新生成 .ts 文件。
  2. 通知翻译团队翻译新的或修改过的文本。
  3. 使用 lrelease 将更新后的 .ts 文件转换为 .qm 文件。
  4. 将新生成的QM文件提交到版本控制系统，并标注版本号。
  5. 在软件发布时，确保使用最新的QM文件进行部署。

在软件国际化的过程中，QM文件的版本控制和更新是确保软件适应不同语言环境的关键步骤。

4. 创建翻译文件的步骤

4.1 翻译文件的结构分析

4.1.1 文本片段的提取与分类

在准备翻译文件时，第一步是提取应用程序中所有需要翻译的文本片段。这包括用户界面上的标签、按钮、菜单项等所有可见文本。文本片段的提取通常借助于专门的工具，例如Qt Linguist，它能够帮助开发者从源代码中识别可翻译的字符串。

在提取过程中，需要对这些文本进行分类，以便在翻译文件中维护其上下文含义。分类可以基于功能模块、界面对话框或者用户操作流程。比如，对于一个设置菜单，其中的每个菜单项和对应的对话框内容都可以视为一个分类单元。

分类的目的是为了更好地管理翻译，确保翻译人员能够理解每个文本片段的具体使用场景，从而提供更准确的翻译。为了实现这一目标，可以使用以下步骤：

  1. 分析程序中的所有字符串，并标识出需要翻译的部分。
  2. 创建一个分类方案，这可以是一个简单的编号系统，也可以是基于软件功能模块的结构化分类。
  3. 将提取的字符串根据分类方案进行整理。

4.1.2 翻译文件的组织结构

翻译文件的组织结构取决于所使用的国际化框架和工具。例如，Qt框架使用的是 .ts 文件作为翻译源文件，而翻译之后会生成 .qm 文件作为最终的翻译文件。在 .ts 文件中，所有的翻译文本片段都以一种清晰的树状结构组织，这样有助于翻译人员快速找到需要翻译的文本，并理解其上下文。

翻译文件中的每个条目都包含以下要素：

  • 源语言文本（Source Text）：需要被翻译的原始文本。
  • 翻译目标文本（Translation Text）：翻译后的文本。
  • 注释（Comments）：提供给翻译人员的上下文信息或特别说明。
  • 位置信息（Location）：源代码文件中的位置，有助于定位原文本。

例如：

<context>
    <message>
        <source>File</source>
        <translation>档案</translation>
        <comment>File menu label</comment>
        <location>mainwindow.ui:25</location>
    </message>
</context>

在上述XML结构中，源语言文本为”File”，翻译后的文本为”档案”。注释部分说明了这个文本片段是文件菜单的标签。位置信息指向了源代码文件的第25行，这是一个用户界面文件（ mainwindow.ui ）。

4.2 利用Qt Linguist进行翻译

4.2.1 Qt Linguist工具的使用方法

Qt Linguist 是一个强大的多语言翻译编辑器，它为翻译人员提供了一个直观且易于使用的界面来编辑翻译文件（ .ts 文件）。使用该工具时，翻译人员可以查看源语言和目标语言的文本，并在界面中直接进行翻译。

Qt Linguist 的使用流程大致如下：

  1. 打开Qt Linguist并加载一个 .ts 文件。
  2. 使用工具的编辑功能对每个条目进行翻译。翻译完成后，可以保存更改。
  3. 翻译人员可以利用上下文帮助和注释理解每个翻译片段的使用环境，减少误解。
  4. Qt Linguist 支持翻译记忆库（Translation Memory）和术语表（Termbase），这有助于保持翻译的一致性和准确性。
  5. 翻译完成后，可以使用Qt Linguist将翻译保存到 .ts 文件中。之后，通过使用 lupdate 和 lrelease 命令，可以将 .ts 文件编译为 .qm 文件。

4.2.2 翻译过程中的注意事项

在翻译过程中，翻译人员需要注意以下几点：

  • 确保翻译准确无误，符合目标语言的语法和习惯。
  • 留意原代码中的占位符或变量标记，如 %1 , %2 等，确保翻译文本的结构与原意保持一致。
  • 遵守翻译记忆库和术语表的规范，以便于术语的一致性管理。
  • 避免使用过长的翻译文本，以防界面布局破坏。如果必须，则与开发人员协商界面设计的调整。
  • 在翻译完毕后，需要进行仔细的校对，尤其是对于复数形式、性别、语态等可能引起歧义的地方。

最终，翻译人员将编辑好的 .ts 文件交回给开发者，由开发者负责生成 .qm 文件并集成到应用程序中。这样，应用程序就可以支持多语言环境了。

5. 将翻译文件集成到项目资源

5.1 集成翻译文件的配置方法

在软件开发中，集成翻译文件是实现多语言支持的关键步骤。本部分将详细介绍如何在Qt项目中配置翻译文件，以及如何动态加载这些文件来切换用户界面语言。

5.1.1 项目资源配置文件的编辑

Qt项目使用 .pro 文件作为资源配置文件。对于国际化，主要关注的是 TRANSLATIONS 变量，该变量列出了所有翻译文件(.qm)的路径。例如：

TRANSLATIONS += translations/app_zh.qm translations/app_fr.qm

上述代码将 app_zh.qm 和 app_fr.qm 文件包含到项目中，分别对应中文和法文翻译。这行配置确保了在构建项目时，翻译文件会被正确地复制到目标目录，并且Qt可以在运行时加载它们。

5.1.2 动态加载翻译文件的策略

动态加载翻译文件是指在应用程序运行时根据用户的语言选择加载相应的.qm文件。以下是动态加载翻译文件的一般步骤：

  1. 创建语言选择界面 ：首先，需要一个界面让用户选择希望使用的语言。
  2. 获取当前系统的语言设置 ：这通常根据用户的系统语言设置来完成。
  3. 加载相应的.qm文件 ：根据用户选择或者系统语言设置，使用 QLocale 和 QTranslator 类动态加载对应的.qm文件。
  4. 调用 retranslateUi 函数 ：对于每个界面组件，调用 retranslateUi() 函数来更新界面文本。

示例代码如下：

#include <QApplication>
#include <QTranslator>
#include <QLocale>
#include <QPushButton>

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

    // 创建翻译器对象
    QTranslator translator;
    // 尝试加载用户选择的语言的qm文件
    if (translator.load(":/translations/app_" + QLocale::system().name())) {
        app.installTranslator(&translator);
    }

    // 创建按钮并设置文本
    QPushButton button("Hello, World!");
    button.show();

    // 运行应用
    return app.exec();
}

在上述代码中，我们首先尝试加载与系统语言相对应的.qm文件，并通过 app.installTranslator() 将翻译器对象安装到应用程序中。这样，当创建界面组件时，它们会自动使用安装的翻译器对象来获取正确的翻译文本。

5.2 集成过程中的常见问题及解决

在将翻译文件集成到项目资源时，可能会遇到跨平台兼容性和资源同步更新等挑战。本小节将介绍这些问题及其解决方案。

5.2.1 跨平台下的兼容性问题

跨平台应用程序在不同操作系统上可能会遇到文件路径、编码或其他系统差异带来的问题。为了解决这些问题，开发者可以采取以下措施：

  • 使用相对路径 ：确保在不同平台上的文件路径保持一致，可以使用 QCoreApplication::applicationDirPath() 获取应用程序的基目录，并构建相对路径。
  • 检查系统编码 ：不同的操作系统可能会使用不同的字符编码，确保应用程序在所有平台上使用统一的编码（如UTF-8）。

5.2.2 资源更新后的同步问题

当翻译文件更新后，用户可能仍在使用旧的翻译资源，这会导致显示不一致的问题。为了解决这个问题，可以采取以下策略：

  • 在应用启动时检查更新 ：应用程序在启动时应检查在线资源库，确认是否有最新的翻译文件。
  • 提供更新机制 ：向用户提供一种简单的方式去更新翻译文件，例如，点击一个按钮即可下载并安装最新的翻译文件。

通过上述方法，可以保证应用程序在不同平台下以及资源更新后的多语言支持的正确性和同步性。

在下一章节中，我们将讨论如何实现翻译文件的加载和在应用程序界面中的应用。

6. 实现翻译加载和应用的编程方法

在创建和管理翻译文件之后，关键的一步是将这些翻译集成到我们的应用程序中，使得软件能够根据用户的语言偏好动态加载相应的翻译。在本章中，我们将探讨如何通过编程方法实现翻译的加载和界面元素的翻译应用。

6.1 动态加载翻译文件

动态加载翻译文件是实现软件多语言支持的关键步骤。它允许应用程序在运行时根据用户的语言选择切换语言，而无需重新启动程序。

6.1.1 动态加载的实现过程

在Qt框架中，动态加载翻译文件涉及到几个关键函数： QCoreApplication::installTranslator() 和 QCoreApplication::removeTranslator() 。以下是实现动态加载的基本步骤：

  1. 创建翻译文件：确保已经生成了对应的 .qm 文件，它包含了所有已翻译的文本。
  2. 使用 QTranslator 类：创建一个 QTranslator 对象，它将被用来加载 .qm 文件。
  3. 安装翻译器：通过调用 installTranslator(&translator) ，将翻译器对象安装到应用程序中。
  4. 语言切换：当用户选择不同的语言时，可以调用 removeTranslator(&translator) 卸载当前翻译器，并安装新的翻译文件。
// 动态加载翻译文件的示例代码
QTranslator translator;
if (translator.load(":/translations/language_" + selectedLanguage + ".qm")) {
    qApp->installTranslator(&translator);
} else {
    qDebug() << "Failed to load translation:" << translator.errorString();
}

6.1.2 翻译加载过程中的性能考量

在动态加载翻译文件时，性能是一个不容忽视的因素。加载一个翻译文件可能会消耗一定的时间和资源。为了优化性能，可以考虑以下方法：

  • 预加载：在应用启动时预先加载所有可能用到的翻译文件，但只安装默认语言的翻译器。当语言切换时，卸载当前翻译器并安装目标翻译器。
  • 按需加载：仅在检测到语言变化时才加载对应的翻译文件。这会减少内存使用，但会增加切换语言时的延迟。

6.2 界面元素的翻译应用

界面元素文本的动态更新是实现多语言支持的另一重要方面。我们需要确保所有的用户界面元素在语言切换时能够正确地显示翻译文本。

6.2.1 界面元素文本的动态更新

在Qt中，可以使用 tr() 函数来标记需要翻译的文本。这有助于编译器识别需要翻译的字符串，并在加载翻译文件时进行替换。以下是如何在界面上应用翻译的示例：

// 界面元素文本动态更新的示例代码
QLabel *label = new QLabel(tr("Welcome!"));
QPushButton *button = new QPushButton(tr("Click Me"));

6.2.2 翻译应用中的上下文处理

翻译文件通常不包含上下文信息，仅包含键值对。因此，在编程时，必须确保上下文信息被妥善处理，以避免歧义和错误的翻译。可以采取以下措施：

  • 使用清晰的键命名：确保翻译键名能够清晰地表示其上下文含义。
  • 避免重复的翻译键：如果同一文本在不同上下文中有不同的翻译，使用不同的键来区分。
  • 利用翻译工具：确保翻译人员能够访问到足够的上下文信息，以便提供准确的翻译。

请注意，以上代码和策略只是编程实现多语言功能的冰山一角。在实际开发中，可能需要根据具体需求和应用架构调整实现细节。

本文还有配套的精品资源，点击获取 menu-r.4af5f7ec.gif

简介：在软件开发中，为满足不同语言用户需求，多语言支持至关重要。本示例展示了如何利用Visual Studio和Qt框架实现在应用程序中轻松切换中英文界面。通过Qt框架的国际化支持，包括使用QTranslator类和.qm文件，我们创建了简体中文和英文版本的翻译文件，并通过编程实现了从一种语言切换到另一种语言的界面。本文详细介绍了创建翻译文件、集成到项目、加载和应用翻译、事件处理、重新绘制界面以及测试与调试的整个流程，为开发者提供了一个中英文界面切换的实用案例，帮助他们更好地实现软件的本地化。


本文还有配套的精品资源，点击获取
menu-r.4af5f7ec.gif

Logo
开源鸿蒙跨平台开发者社区

开源鸿蒙跨平台开发社区汇聚开发者与厂商，共建“一次开发，多端部署”的开源生态，致力于降低跨端开发门槛，推动万物智联创新。

更多推荐

Flutter 三方库 flutter_view_trailer 的鸿蒙化适配指南

嘿，各位开发者小伙伴们！今天要跟大家分享一个超级有趣的话题——如何在鸿蒙设备上实现炫酷的页面转场效果！想象一下，当用户点击一个按钮，页面不是干巴巴地跳转，而是像变魔术一样优雅地过渡，是不是瞬间感觉应用的高级感拉满了？作为一名在 Flutter 和鸿蒙双平台摸爬滚打的开发者，我最近接到了一个颇具挑战的任务：将 flutter_view_trailer 这个页面转场预览库适配到 OpenHarmony

avatar 开源鸿蒙跨平台开发者社区
cover

React Native 双端一体工程，如何实现分端运行与分端打包？

avatar 开源鸿蒙跨平台开发者社区
cover

开源鸿蒙跨平台深度解析：Flutter Pigeon 跨平台官方示例适配全流程与底层故障溯源

avatar 开源鸿蒙跨平台开发者社区