2026-07-14 01:37:06 +00:00
|
|
|
|
客户端文档入口
|
|
|
|
|
|
==============
|
|
|
|
|
|
|
|
|
|
|
|
本目录用于保存 update-client 客户端子仓库的说明文档。
|
|
|
|
|
|
|
|
|
|
|
|
建议阅读顺序：
|
|
|
|
|
|
|
|
|
|
|
|
1. 客户端部署说明.md
|
|
|
|
|
|
面向接入和部署，说明 SDK 是什么、怎么放到业务软件目录、app_config.json 怎么填、如何打包。
|
|
|
|
|
|
|
|
|
|
|
|
2. 第三方依赖说明.md
|
2026-07-14 08:39:41 +00:00
|
|
|
|
面向编译环境，说明 Windows/Linux 下 Qt、OpenSSL、thirdparty/ 和 CMake 环境变量怎么配置。
|
2026-07-14 01:37:06 +00:00
|
|
|
|
|
2026-07-14 03:51:42 +00:00
|
|
|
|
3. ../i18n/ReadMe.txt
|
|
|
|
|
|
面向国际化维护，说明新增 tr() 文案后如何更新 .ts、生成 .qm，以及 .qrc 如何内嵌翻译资源。
|
|
|
|
|
|
|
|
|
|
|
|
4. 本 ReadMe.txt
|
2026-07-14 01:37:06 +00:00
|
|
|
|
记录客户端配置文件和打包脚本的简要说明。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
客户端配置说明
|
|
|
|
|
|
==============
|
|
|
|
|
|
|
2026-07-14 08:39:41 +00:00
|
|
|
|
config/app_config.json 是部署配置源文件。Launcher / Updater / MainApp 启动时会把它同步到当前用户的 QSettings 配置区；Windows 下对应注册表，Linux 下对应用户配置文件。后续运行配置优先从 QSettings 读取。
|
2026-07-14 01:37:06 +00:00
|
|
|
|
如果 config/app_config.json 内容被修改，下一次启动时会按解析后的 JSON 内容 SHA256 判断变化并重新导入注册表。
|
2026-07-14 08:39:41 +00:00
|
|
|
|
非空 app_config.json 成功导入注册表后会自动清空为 {}，文件保留不删除，方便下次直接粘贴管理后台生成的新配置。
|
|
|
|
|
|
Windows 注册表位置：HKEY_CURRENT_USER\Software\Marsco\UpdateClientSDK\installations\<安装目录SHA256>\config。
|
|
|
|
|
|
Linux 配置位置由 Qt QSettings 决定，通常在当前用户 home 目录的 .config/Marsco/UpdateClientSDK.conf 一类路径下。
|
|
|
|
|
|
如果检测到 app_config.json 发生变化，SDK 会删除 config/client_identity.dat、config/version_policy.dat 和 config/local_state.json，避免继续使用旧授权身份、旧策略或旧防回滚状态；目录不可写时会弹出管理员权限确认框。
|
|
|
|
|
|
正常启动成功后不要删除这些状态文件，它们用于本地身份、离线策略和安全状态。
|
2026-07-14 01:37:06 +00:00
|
|
|
|
首次运行时如果该文件不存在且发现旧 client.ini，会自动迁移。
|
|
|
|
|
|
|
|
|
|
|
|
接入新软件时通常需要修改：
|
|
|
|
|
|
|
|
|
|
|
|
1. app_id、app_name、channel、current_version。
|
|
|
|
|
|
2. api_base_url、client_token、license_key、launch_token。
|
|
|
|
|
|
3. main_executable：团队业务主程序文件名。
|
|
|
|
|
|
4. launcher_executable、updater_executable、bootstrap_executable。
|
|
|
|
|
|
5. health_check_timeout_ms：升级后等待业务程序健康确认的毫秒数，最小 1000。
|
|
|
|
|
|
|
2026-07-14 08:39:41 +00:00
|
|
|
|
Windows 完整格式参考 update-client/config/app_config.example.json；Linux 完整格式参考 update-client/config/app_config.linux.example.json。
|
2026-07-14 01:37:06 +00:00
|
|
|
|
运行时生成的 client_identity.dat、local_state.json 等文件不得打入通用 SDK 模板。app_config.json 可以作为部署模板，但不要把某台机器运行后产生的临时状态混进去。
|
|
|
|
|
|
|
|
|
|
|
|
Windows 发布打包：
|
|
|
|
|
|
|
|
|
|
|
|
1. 使用 Release 配置编译全部客户端程序。
|
|
|
|
|
|
2. 先完成当前版本在线校验，确认 out/bin/update/manifest_cache 中存在对应的签名 Manifest。
|
|
|
|
|
|
3. 准备一份实际 app_config.json，确认其中包含正确的 License Key、当前版本和业务程序名。
|
|
|
|
|
|
4. 在 PowerShell 执行：
|
|
|
|
|
|
powershell -ExecutionPolicy Bypass -File .\scripts\package-client.ps1 -ConfigFile .\config\app_config.json
|
|
|
|
|
|
5. 输出位于 dist/UpdateClient 和 dist/UpdateClient.zip。
|
|
|
|
|
|
|
|
|
|
|
|
脚本会拒绝 Debug DLL、PDB、嵌套重复主程序和缺少签名 Manifest 的发布源目录。
|
