QT/QML国际化：中英文界面切换显示(cmake方式使用)

server/2024/9/23 7:23:29/

目录

前言

实现步骤

1. 准备翻译文件

2. 翻译字符串

3.设置应用程序语言

cmake 构建方式

示例代码

总结

1. 使用 file(GLOB ...)

2. 引入其他资源文件

再次生成翻译文件

5. 手动更新和生成.qm文件

其他资源

前言

在当今全球化的软件开发环境中，应用程序的国际化（i18n）与本地化（l10n）能力已成为衡量其专业度和用户体验的重要标准之一。QT/QML作为一套强大的跨平台应用程序开发框架，其内置的国际化支持机制使得开发者能够轻松地为应用添加多语言功能，从而满足不同地域用户的语言需求。本文将深入探讨如何在QT/QML项目中实现中英文显示的国际化，从基础概念到具体实施步骤，帮助开发者构建出更加友好、包容的应用界面。

QT框架提供了完整的国际化支持，包括字符串提取、翻译文件的创建与管理、以及运行时的动态加载等。QML作为QT用于构建用户界面的声明式语言，也完全融入了这一国际化体系，让开发者能以简洁高效的方式实现界面的多语言切换。

实现步骤

在QT/QML应用中实现国际化（i18n）以支持中英文显示，主要涉及以下几个步骤：

1. 准备翻译文件

创建翻译文件：使用Qt Linguist工具（QT自带的工具）或手动创建.ts（Translation Source）文件。通常为每种语言创建一个，例如en.ts用于英语，zh.ts用于中文。

提取字符串：使用lupdate工具从源代码中提取可翻译的字符串到.ts文件中。这包括QML文件中的qsTr()或qsTranslate()包裹的文本。

2. 翻译字符串

翻译.ts文件：使用Qt Linguist工具(QT自带)或其他翻译工具编辑.ts文件，将英文字符串翻译成目标语言（如中文）。

编译.ts文件为.qm：使用lrelease工具将翻译好的.ts文件编译为二进制的.qm（Qt Message File）文件，这是运行时加载的文件。

3.设置应用程序语言

动态切换语言：可以通过修改QLocale或直接设置Application的语言来改变界面语言。

cmake 构建方式

生成Qt的ts翻译文件，编辑CMakeLists.txt文件，使用qt5_create_translation。

# 设置翻译源文件(.ts)的输出目录
#set(QML_FILES ${CMAKE_CURRENT_SOURCE_DIR}/source/qml/main.qml)
# 使用 file(GLOB ...) 获取所有 QML 文件
file(GLOB_RECURSE QML_FILES ${CMAKE_CURRENT_SOURCE_DIR}/source/qml/*.qml)
set(TS_FILES${CMAKE_CURRENT_BINARY_DIR}/translations/daemon_en_US.ts${CMAKE_CURRENT_BINARY_DIR}/translations/daemon_zh_CN.ts)# 关键
find_package(Qt5LinguistTools)
qt5_create_translation(QM_FILES ${QML_FILES} ${TS_FILES} OPTIONS -source-language en_US -no-obsolete)# 添加可执行文件
add_executable(${PROJECT_NAME} ${SOURCES} ${HEADERS} ${QML_FILES} ${QM_FILES})

注意，必须将 ${QM_FILES}加入到add_executable参数中才能在编译时生成只有原文的ts文件

ts文件会在“清除”或重新编译的时候一并被删除，再编译的时候生成全新的ts（原有的翻译会丢失，万分注意！!）

示例代码

假设您的 C++ 代码如下：

#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QTranslator>
#include <QLocale>
#include <QQmlContext>int main(int argc, char *argv[])
{QGuiApplication app(argc, argv);// 创建翻译器对象QTranslator translator;// 初始化加载翻译文件（默认载入英文）translator.load(":/translations/daemon_en_US.qm");app.installTranslator(&translator);QQmlApplicationEngine engine;// 将翻译器对象设置到 QML 上下文环境中engine.rootContext()->setContextProperty("translator", &translator);engine.load(QUrl(QStringLiteral("qrc:/source/qml/main.qml")));return app.exec();
}

在 QML 文件中，假设您有如下内容：

import QtQuick 2.12
import QtQuick.Controls 2.12ApplicationWindow {visible: truewidth: 640height: 480title: qsTr("Hello World")Column {anchors.centerIn: parentspacing: 20Text {id: labeltext: qsTr("This is a text")}Button {text: "Switch to Chinese"onClicked: {// 动态切换到中文if (translator.load(":/translations/daemon_zh_CN.qm")) {Qt.application.installTranslator(translator);label.text = qsTr("This is a text");  // 触发翻译更新}}}Button {text: "Switch to English"onClicked: {// 动态切换到英文if (translator.load(":/translations/daemon_en_US.qm")) {Qt.application.installTranslator(translator);label.text = qsTr("This is a text");  // 触发翻译更新}}}}
}

在这个例子中，通过 engine.rootContext()->setContextProperty("translator", &translator); 这一行代码，QML 中的 translator 对象和 C++ 中的翻译器对象关联起来，使得 QML 中能够调用 C++ 的方法来动态加载翻译文件并自动更新界面显示的语言。

总结

通过将翻译器对象设置为 QML 上下文的属性，可以在 QML 中调用 translator 对象的函数，实现动态加载和切换翻译文件的功能，从而满足多语言动态切换的需求。

其中 engine.rootContext()->setContextProperty("translator", &translator); 的主要作用是将 C++ 对象暴露给 QML，以便在 QML 中直接使用和操控这个对象，使得多语言支持更具灵活性和动态性。

以下是一个将QML文件夹下的所有QML文件引入到CMakeLists.txt中的方法：

1. 使用 file(GLOB ...)

file(GLOB ...) 可以递归地获取指定目录下的所有符合条件的文件。这种方法非常灵活，适用于需要引入一组文件的场景。

cmake_minimum_required(VERSION 3.12)project(daemon VERSION 1.0)set(CMAKE_CXX_STANDARD 11)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUIC ON)find_package(Qt5 COMPONENTS Core Quick LinguistTools REQUIRED)# 设置源文件和头文件
set(SOURCESmain.cppsource/cpp/myclass.cpp
)set(HEADERSsource/cpp/myclass.h
)# 使用 file(GLOB ...) 获取所有 QML 文件
file(GLOB_RECURSE QML_FILES ${CMAKE_CURRENT_SOURCE_DIR}/source/qml/*.qml)# 设置翻译文件
set(TS_FILES${CMAKE_CURRENT_SOURCE_DIR}/translations/daemon_en_US.ts${CMAKE_CURRENT_SOURCE_DIR}/translations/daemon_zh_CN.ts
)# 创建翻译文件
qt5_create_translation(QM_FILES TS_FILES ${TS_FILES} QML_FILES ${QML_FILES})# 添加可执行文件
add_executable(${PROJECT_NAME} ${SOURCES} ${HEADERS} ${QML_FILES} ${QM_FILES})# 链接Qt库
target_link_libraries(${PROJECT_NAME} Qt5::Core Qt5::Quick)

在这个示例中：

  • file(GLOB_RECURSE QML_FILES ${CMAKE_CURRENT_SOURCE_DIR}/source/qml/*.qml)：这一步使用通配符*.qml来递归获取source/qml目录下的所有QML文件，并将结果存储到QML_FILES变量中。
  • 剩余的CMake配置保留了引入其他源文件和头文件，以及Qt翻译文件的生成和处理。

2. 引入其他资源文件

如果您的QML项目中还有其他类型的资源文件（如图像文件、.js文件等），也可以使用类似的方法引入：

# 引入图像资源文件
file(GLOB_RECURSE IMAGE_FILES ${CMAKE_CURRENT_SOURCE_DIR}/source/images/*)# 引入JavaScript文件
file(GLOB_RECURSE JS_FILES ${CMAKE_CURRENT_SOURCE_DIR}/source/js/*.js)

将这些文件添加到目标中：

add_executable(${PROJECT_NAME} ${SOURCES} ${HEADERS} ${QML_FILES} ${QM_FILES} ${IMAGE_FILES} ${JS_FILES})

通过这种方式，可以灵活地管理和组织项目中的各种资源文件，简化CMake配置，确保正确引入所有需要的文件。

再次生成翻译文件

确保您的.ts文件已正确配置并包含在项目中。尝试手动运行lupdate命令并查看输出：

cd path_to_your_project
lupdate source/qml/*.qml source/cpp/*.cpp -ts translations/daemon_en_US.ts translations/daemon_zh_CN.ts

然后使用linguist工具打开.ts文件，确认其中是否包含待翻译文本：

linguist translations/daemon_zh_CN.ts

5. 手动更新和生成.qm文件

如果依旧遇到问题，可以尝试手动更新ts文件并生成qm文件，以确保流程正确：

# 手动更新 TS 文件
lupdate source/qml/*.qml source/cpp/*.cpp -ts translations/daemon_en_US.ts translations/daemon_zh_CN.ts# 使用Qt Linguist工具编辑并保存 TS 文件
linguist translations/daemon_en_US.ts
linguist translations/daemon_zh_CN.ts# 手动生成 QM 文件
lrelease translations/daemon_en_US.ts
lrelease translations/daemon_zh_CN.ts

在以上步骤中，验证所有QML和C++文件中确实包含带有qsTr()或tr()的翻译标记，并确认lupdate和lrelease工具的路径和执行是否正确。如果所有步骤正确完成，生成的.qm文件会包含预期的翻译数据。

注意：

lupdate工具本身不会自动进行翻译。它的主要功能是从源代码和QML文件中提取出所有标记为需要翻译的字符串，并生成或更新.ts文件。这些.ts文件是XML格式的翻译源文件，其中包含了需要翻译的原始字符串及其上下文信息，但并不会包含任何自动生成的翻译。

生成的.ts文件中所有翻译项最初都是未翻译状态，开发人员或翻译人员需要手动使用Qt Linguist工具为每个字符串提供翻译。

对于QML中的文本，应该使用qsTr()函数来包裹那些需要翻译的字符串。例如：

Text {text: qsTr("Hello, World!")}

在C++代码中，你应该使用tr()宏来标记需要翻译的字符串。例如：

QString message = tr("Welcome to the application.");

确保所有的用户可见的字符串都通过tr()进行了包裹。这包括但不限于对话框消息、菜单项、按钮标签等。

避免在代码逻辑中使用硬编码的字符串：无论是QML还是C++，都应该避免直接在逻辑处理中使用未经qsTr()或tr()处理的字符串。如果字符串中包含变量或需要格式化的地方，使用占位符（如C++中的arg()方法或QML中的字符串插值）并确保翻译时考虑这些变量的存在。

qsTr()和tr()是分别在QML和C++中进行国际化的基本手段，通过它们确保字符串可以被翻译工具识别并处理。

总结：

  • lupdate 提取源字符串并生成 .ts 文件，不会自动翻译。
  • 使用 linguist 工具手动翻译 .ts 文件内容。
  • 使用 lrelease 生成 .qm 文件以供应用程序使用。

通过这个流程，您可以管理和使用Qt项目中的翻译文件，实现应用程序的多语言支持。

其他资源

https://www.cnblogs.com/Paoyao/p/15752116.html

https://zhuanlan.zhihu.com/p/379477970

配置CLion管理Qt项目国际化支持的方法_C 语言_脚本之家

Qt之Qml 国际化—实现简易语言切换功能_qml 中英文切换-CSDN博客

Qt / Qml 中支持多国语言_qml 多语言-CSDN博客


http://www.ppmy.cn/server/53513.html

相关文章

金榜题名升学宴，怀庄之醉鸿运添彩

金榜题名升学宴，怀庄之醉鸿运添彩

十年寒窗苦读&#xff0c;终于迎来金榜题名的辉煌时刻。这是对知识的向往与追求&#xff0c;也是对未来的期许与梦想。在这样一个值得纪念的时刻&#xff0c;举办一场升学宴&#xff0c;无疑是对过去努力的最好告别&#xff0c;也是对未来人生新旅程的美好祝愿。在选择升学宴用…
阅读更多...
简易版图书借阅系统（可操作数据库）

简易版图书借阅系统（可操作数据库）

图书借阅系统 数据库表&#xff1a; 用户表&#xff1a;id,用户名&#xff0c;密码 图书表&#xff1a;id,图书名称&#xff0c;图书价格&#xff0c;出版社&#xff0c;作者&#xff0c;可借阅数量 借阅表&#xff1a;id,用户id,图书id,借阅时间,归还时间 &#…
阅读更多...
HarmonyOS Next开发学习手册——弹性布局 (Flex)

HarmonyOS Next开发学习手册——弹性布局 (Flex)

概述 弹性布局&#xff08; Flex &#xff09;提供更加有效的方式对容器中的子元素进行排列、对齐和分配剩余空间。常用于页面头部导航栏的均匀分布、页面框架的搭建、多行数据的排列等。 容器默认存在主轴与交叉轴&#xff0c;子元素默认沿主轴排列&#xff0c;子元素在主轴…
阅读更多...
编译工具-Gradle

编译工具-Gradle

文章目录 Idea中配置Gradle项目project目录settings.gradlebuild.gradlegradlewgradlew.bat Gradle Build生命周期编写Settings.gradle编写Build.gradleTasksPlugins Idea中配置 配置项&#xff1a;gradle位置 及仓库位置 Gradle项目 Task&#xff0c;settings.gradle,build.…
阅读更多...
vue项目纯前端实现导出pdf文件

vue项目纯前端实现导出pdf文件

1、下载插件 npm install html2canvas npm install jspdf2、创建htmlToPdf.js&#xff0c;地址&#xff1a;src/utils/htmlToPdf.js import html2Canvas from html2Canvas import JsPDF from jspdf export default { install(Vue, options) { Vue.prototype.getPdfFromH…
阅读更多...
基于STM32的PWM实现LED调光效果详解

基于STM32的PWM实现LED调光效果详解

STM32单片机PWM引脚的使用详解 引言 STM32单片机是现代嵌入式系统中广泛使用的微控制器系列之一。它以其高性能、低功耗和丰富的外设资源而著称。在众多外设中&#xff0c;PWM&#xff08;脉宽调制&#xff09;功能尤为重要&#xff0c;广泛应用于电机控制、LED调光、音频信号生…
阅读更多...
医学预测模型web APP的制作建议

医学预测模型web APP的制作建议

医学预测模型web APP的制作建议 医学预测模型类web APP定义为承载预测模型而便利预测模型临床应用的可视化客户端。 医学预测模型类web APP的功能是衔接预测模型和临床实践&#xff0c;让用户正确地&#xff0c;方便地使用预测模型并恰当地理解预测模型的结果&#xff0c;在此…
阅读更多...
资料导览（持续更新）

资料导览（持续更新）

经典推荐 多模态大模型&#xff1a;基础架构 图解DSPy&#xff1a;Prompt的时代终结者&#xff1f;&#xff01; vLLM, LMDeploy, MLC-LLM, TensorRT-LLM, and TGI的性能小实验 优雅谈大模型13&#xff1a;一文读懂LoRA/DoRA/MoRA 新鲜速递&#xff1a;图解新颖LLM的CoPE位…
阅读更多...
最新文章

Copyright @ 2022~2023