docs(i18n): 补充国际化编译说明

This commit is contained in:
2026-07-14 03:51:42 +00:00
parent 94b20bf2bb
commit c960d3b04d
2 changed files with 83 additions and 1 deletions
+79
View File
@@ -0,0 +1,79 @@
客户端国际化说明
================
本目录保存 Qt 国际化资源。
文件说明:
1. update-client_zh_CN.ts
翻译源文件。新增或修改代码里的 tr() 文案后,需要更新这个文件,再补中文翻译。
2. update-client_zh_CN.qm
Qt 运行时加载的二进制翻译文件。它由 .ts 编译生成,不要手工编辑。
3. update-client.qrc
Qt 资源文件。它会把 update-client_zh_CN.qm 编进 Launcher / Updater / MainApp,不需要把 .qm 单独暴露到安装目录。
日常编译
========
普通重新生成项目时,CMake 会自动执行 lrelease,把 update-client_zh_CN.ts 编译成 update-client_zh_CN.qm。
Visual Studio 里直接选择 x64 Release 或 x64 Debug,然后“全部重新生成”即可。
命令行等价操作:
```powershell
cmake --build --preset x64-release
```
新增界面文字后的流程
====================
如果代码里新增了 QObject::tr(...)、QCoreApplication::translate(...) 等需要翻译的文字,按下面步骤操作:
1. 更新 .ts 文件。
Visual Studio
在 CMake 目标里生成 update_client_lupdate。
PowerShell
```powershell
cd C:\Users\admin\Desktop\update-client
cmake --build --preset x64-release --target update_client_lupdate
```
2. 打开 i18n/update-client_zh_CN.ts,补齐新增 source 对应的 translation。
可以用 Qt Linguist 打开,也可以直接用文本编辑器编辑 XML。
3. 重新生成翻译和程序。
Visual Studio
“全部重新生成”即可。
PowerShell
```powershell
cmake --build --preset x64-release
```
如果只想单独生成 .qm
```powershell
cmake --build --preset x64-release --target update_client_translations
```
注意事项
========
1. 代码里不要直接写中文界面文字,统一写英文 source,再在 .ts 里翻译成中文。
2. .qm 已经通过 update-client.qrc 编进 exe,交付包里不需要单独放翻译文件。
3. 如果 Visual Studio 或 CMake 找不到 lupdate / lrelease,通常是 Qt 环境变量没配好。确认 CMAKE_PREFIX_PATH 或 Qt5_DIR 指向 Qt 5.15.2 的 msvc2019_64 目录。
4. update_client_lupdate 只在新增或修改 tr() 文案后需要手动生成;普通代码修改只需要正常重新生成项目。