Syncthing Windows Setup 项目构建与本地化指南

项目概述

Syncthing Windows Setup 是一个基于 Inno Setup 的 Windows 安装程序项目，专门用于部署和配置 Syncthing 文件同步工具。该项目提供了完整的安装解决方案，包括二进制文件部署、服务管理、防火墙规则配置等功能。

项目文件结构解析

该项目包含多个关键文件和目录，理解它们的用途对构建和定制安装程序至关重要：

1. 核心组件：

   • binaries 目录：存放 32 位(i386)和 64 位(x86_64)架构的二进制文件
   • Syncthing.iss：Inno Setup 的主脚本文件，控制整个安装流程
   • SetupVersion.ini：定义安装程序的版本信息

2. 辅助工具：

   • jq.exe：轻量级命令行 JSON 处理器
   • ProcessCheck.dll：用于进程检查的动态链接库
   • unzip.exe：解压缩工具

3. 本地化文件：

   • 语言特定的 RTF 文件：如 en-License.rtf 和 en-README.rtf
   • 语言特定的脚本文件：如 en-SetSyncthingConfig.js
   • 语言消息文件：如 Messages-en.isl

构建准备

获取项目文件

1. 下载项目压缩包并解压到本地目录
2. 准备必要的二进制文件：
   • 32 位版本放入 binaries\i386 目录
   • 64 位版本放入 binaries\x86_64 目录

所需工具说明

• Inno Setup：Windows 平台广泛使用的安装程序制作工具
• jq：用于处理 JSON 配置文件的轻量级工具
• ProcessCheck：用于检测和管理进程的辅助库
• UnZip：传统的解压缩工具

构建安装程序

使用 Inno Setup 编译 Syncthing.iss 脚本文件，生成的可执行文件将命名为 syncthing-windows-setup.exe。

构建建议：

1. 确保所有依赖文件已就位
2. 检查版本号是否正确
3. 验证二进制文件路径配置

本地化实现详解

为安装程序添加新语言支持需要以下系统化的步骤：

1. 创建语言消息文件

复制现有的 Messages-en.isl 文件并重命名为目标语言代码（如 Messages-fr.isl），然后翻译其中的所有字符串。

2. 准备本地化文档

• 翻译许可证文件为 RTF 格式（如 fr-License.rtf）
• 翻译 README 文件为 RTF 格式（如 fr-README.rtf）

3. 修改主脚本

在 Syncthing.iss 的 [Languages] 部分添加新语言条目，例如法语：

[Languages]
Name: "fr"; MessagesFile: "compiler:Languages\French.isl,Messages-fr.isl"; InfoBeforeFile: "fr-README.rtf"

4. 本地化脚本文件

复制并翻译所有以 en- 开头的 JavaScript 脚本文件，注意：

• 保持脚本逻辑不变，仅翻译用户可见的字符串
• 建议使用 UTF-16 LE 编码保存，确保特殊字符正确显示

5. 更新本地化配置

在 Localization.ini 中添加新语言段，关联所有相关文件：

[fr]
LicenseFile=fr-License.rtf
ScriptNameSetSyncthingConfig=fr-SetSyncthingConfig.js
; 其他脚本文件映射...

6. 更新构建配置

1. 增加 NumLanguages 预处理指令的值
2. 在 Languages 数组中添加新语言项

本地化最佳实践

1. 编码问题：非英语脚本文件建议使用 UTF-16 LE 编码
2. 术语一致性：保持技术术语翻译的一致性
3. 长度考虑：某些语言翻译后文本可能变长，需测试UI适配性
4. 文化适配：注意日期、数字格式等本地化差异

实际案例：添加荷兰语支持

1. 创建 Messages-nl.isl 并翻译所有字符串
2. 准备 nl-License.rtf 和 nl-README.rtf
3. 复制并翻译所有脚本文件为荷兰语版本
4. 更新 Localization.ini 添加荷兰语配置
5. 修改 Syncthing.iss 增加荷兰语支持

通过以上系统化的步骤，可以为 Syncthing Windows Setup 添加任意语言支持，使其能够服务于更广泛的用户群体。