177 lines
4.7 KiB
Plaintext
177 lines
4.7 KiB
Plaintext
客户端国际化说明
|
||
================
|
||
|
||
这份文档说明 Qt 国际化文件怎么维护，以及哪些步骤是自动的、哪些步骤需要你手动做。
|
||
|
||
先看结论
|
||
========
|
||
|
||
Visual Studio 和 PowerShell 二选一即可。
|
||
|
||
- Visual Studio 是图形界面入口。
|
||
- PowerShell 是命令行入口。
|
||
- 两者最终调用的是同一套 CMake 目标，不是两套流程。
|
||
|
||
最重要的规则：
|
||
|
||
1. 普通“全部重新生成”会自动把已有的 update-client_zh_CN.ts 编译成 update-client_zh_CN.qm。
|
||
2. 普通“全部重新生成”不会自动扫描源码生成新的 update-client_zh_CN.ts 条目。
|
||
3. 如果新增了 QObject::tr(...)、QCoreApplication::translate(...) 这类新文案，必须先手动生成一次 update_client_lupdate。
|
||
4. 你编辑完 update-client_zh_CN.ts 后，再“全部重新生成”，CMake 会自动生成 .qm，并通过 qrc 打进程序。
|
||
|
||
文件说明
|
||
========
|
||
|
||
1. update-client_zh_CN.ts
|
||
翻译源文件，XML 格式。新增或修改代码里的 tr()/translate() 文案后，需要更新这个文件，再补中文翻译。
|
||
|
||
2. update-client_zh_CN.qm
|
||
Qt 运行时加载的二进制翻译文件。它由 .ts 编译生成，不要手工编辑。
|
||
|
||
3. update-client.qrc
|
||
Qt 资源文件。它会把 update-client_zh_CN.qm 编进 Launcher、Updater、Bootstrap、MainApp，不需要把 .qm 单独放到安装目录。
|
||
|
||
日常编译：没有新增界面文字
|
||
==========================
|
||
|
||
这种情况最简单。
|
||
|
||
你只是改了普通 C++ 代码，或者只是修改了 update-client_zh_CN.ts 里已有条目的中文翻译：
|
||
|
||
Visual Studio：
|
||
|
||
```text
|
||
选择 x64 Release 或 x64 Debug -> 全部重新生成
|
||
```
|
||
|
||
PowerShell 等价命令：
|
||
|
||
```powershell
|
||
cd C:\Users\admin\Desktop\update-client
|
||
cmake --build --preset x64-release
|
||
```
|
||
|
||
这时 CMake 会自动执行 lrelease：
|
||
|
||
```text
|
||
update-client_zh_CN.ts -> update-client_zh_CN.qm
|
||
```
|
||
|
||
然后 .qm 会通过 update-client.qrc 打进 exe。
|
||
|
||
新增界面文字后的完整流程
|
||
========================
|
||
|
||
如果代码里新增了这些文字：
|
||
|
||
```cpp
|
||
QObject::tr("New message")
|
||
QCoreApplication::translate("Context", "New message")
|
||
```
|
||
|
||
只点“全部重新生成”是不够的。因为“全部重新生成”不会自动扫描源码，把新 source 写进 .ts。
|
||
|
||
正确流程是：
|
||
|
||
1. 先更新 .ts 文件。
|
||
|
||
Visual Studio：
|
||
|
||
```text
|
||
在 CMake 目标里找到 update_client_lupdate，然后生成这个目标。
|
||
```
|
||
|
||
PowerShell 等价命令：
|
||
|
||
```powershell
|
||
cd C:\Users\admin\Desktop\update-client
|
||
cmake --build --preset x64-release --target update_client_lupdate
|
||
```
|
||
|
||
这一步会扫描 Common、Bootstrap、Launcher、Updater、MainApp 里的 cpp/h 文件，把新增的 tr()/translate() 文案写入：
|
||
|
||
```text
|
||
i18n/update-client_zh_CN.ts
|
||
```
|
||
|
||
2. 编辑 update-client_zh_CN.ts。
|
||
|
||
找到新增的 `<source>...</source>`，把对应 `<translation>...</translation>` 补成中文。
|
||
|
||
可以用 Qt Linguist 打开，也可以直接用文本编辑器编辑 XML。
|
||
|
||
3. 再重新生成程序。
|
||
|
||
Visual Studio：
|
||
|
||
```text
|
||
全部重新生成
|
||
```
|
||
|
||
PowerShell 等价命令：
|
||
|
||
```powershell
|
||
cmake --build --preset x64-release
|
||
```
|
||
|
||
这一步会自动做：
|
||
|
||
```text
|
||
update-client_zh_CN.ts -> update-client_zh_CN.qm -> update-client.qrc -> exe
|
||
```
|
||
|
||
如果只想单独生成 .qm
|
||
====================
|
||
|
||
一般不需要单独做。普通编译会自动生成 .qm。
|
||
|
||
如果你只是想检查 .ts 能不能正常编译成 .qm，可以单独生成这个目标：
|
||
|
||
Visual Studio：
|
||
|
||
```text
|
||
生成 CMake 目标 update_client_translations
|
||
```
|
||
|
||
PowerShell：
|
||
|
||
```powershell
|
||
cd C:\Users\admin\Desktop\update-client
|
||
cmake --build --preset x64-release --target update_client_translations
|
||
```
|
||
|
||
常见问题
|
||
========
|
||
|
||
1. 新增了 tr()，为什么程序里没有中文？
|
||
|
||
通常是少做了 update_client_lupdate。新增文案后必须先更新 .ts，再补中文，再重新生成。
|
||
|
||
2. 我只改了 .ts 里的中文，还要跑 update_client_lupdate 吗？
|
||
|
||
不需要。直接“全部重新生成”即可，CMake 会自动重新生成 .qm。
|
||
|
||
3. update-client_zh_CN.qm 要不要交付到安装目录？
|
||
|
||
不需要。它已经通过 update-client.qrc 编进 exe。
|
||
|
||
4. 代码里能不能直接写中文？
|
||
|
||
不建议。界面文字统一写英文 source，然后在 .ts 里翻译成中文。
|
||
|
||
5. Visual Studio 或 CMake 找不到 lupdate / lrelease 怎么办？
|
||
|
||
通常是 Qt 环境变量没配好。确认 CMAKE_PREFIX_PATH 或 Qt5_DIR 指向 Qt 目录。
|
||
|
||
Windows 示例：
|
||
|
||
```powershell
|
||
[Environment]::SetEnvironmentVariable("CMAKE_PREFIX_PATH", "C:\Qt\5.15.2\msvc2019_64", "User")
|
||
```
|
||
|
||
Linux 示例：
|
||
|
||
```bash
|
||
sudo apt install -y qttools5-dev-tools
|
||
```
|