update-client/Docs/第三方依赖说明.md

第三方依赖说明

thirdparty/ 是本机依赖目录，已经被 .gitignore 忽略，不会提交到 Git。

当前客户端构建依赖：

1. Qt 5.15.2 msvc2019_64
2. OpenSSL-Win64

1. Qt 配置

Qt 路径由本机环境变量提供。你需要在 Windows 环境变量里配置 Qt 路径，让 CMake 的 find_package(Qt5 ...) 能找到 Qt。

推荐配置用户环境变量 CMAKE_PREFIX_PATH：

[Environment]::SetEnvironmentVariable("CMAKE_PREFIX_PATH", "C:\Qt\5.15.2\msvc2019_64", "User")

设置完成后，重新打开 PowerShell 或 Visual Studio。

如果只想对当前 PowerShell 窗口临时生效：

$env:CMAKE_PREFIX_PATH="C:\Qt\5.15.2\msvc2019_64"

也可以配置更精确的 Qt5_DIR：

[Environment]::SetEnvironmentVariable("Qt5_DIR", "C:\Qt\5.15.2\msvc2019_64\lib\cmake\Qt5", "User")

CMAKE_PREFIX_PATH 和 Qt5_DIR 二选一即可，推荐使用 CMAKE_PREFIX_PATH。

一般不需要把 C:\Qt\5.15.2\msvc2019_64\bin 加入 Path。项目构建后会通过 windeployqt 复制运行所需的 Qt DLL。

2. OpenSSL 配置

OpenSSL 默认放在：

thirdparty/OpenSSL-Win64

推荐目录结构：

thirdparty/
  OpenSSL-Win64/
    include/
      openssl/
    lib/
      VC/
        x64/
          MD/
          MDd/

复制命令示例：

cd C:\Users\admin\Desktop\update-client
mkdir thirdparty
Copy-Item "C:\Program Files\OpenSSL-Win64" ".\thirdparty\OpenSSL-Win64" -Recurse

如果 OpenSSL 不放在 thirdparty/，可以在配置 CMake 时手动指定：

cmake -S . -B out\build\x64-Debug `
  -G "Visual Studio 17 2022" `
  -A x64 `
  -DSIMCAE_OPENSSL_ROOT="C:\Program Files\OpenSSL-Win64"

3. 重新配置和编译

如果之前配置过 CMake，建议先删除旧缓存：

cd C:\Users\admin\Desktop\update-client
Remove-Item out\build -Recurse -Force

重新配置：

cmake -S . -B out\build\x64-Debug `
  -G "Visual Studio 17 2022" `
  -A x64

编译：

cmake --build out\build\x64-Debug --config Debug

4. 提交注意事项

不要提交下面这些内容：

thirdparty/
.vs/
out/
build/
dist/
App/
*.exe
*.dll
*.lib
*.pdb

这些都属于本机依赖、构建产物或打包产物，不应该进 Git。