118 lines
2.3 KiB
Markdown
118 lines
2.3 KiB
Markdown
# 第三方依赖说明
|
||
|
||
`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`：
|
||
|
||
```powershell
|
||
[Environment]::SetEnvironmentVariable("CMAKE_PREFIX_PATH", "C:\Qt\5.15.2\msvc2019_64", "User")
|
||
```
|
||
|
||
设置完成后，重新打开 PowerShell 或 Visual Studio。
|
||
|
||
如果只想对当前 PowerShell 窗口临时生效：
|
||
|
||
```powershell
|
||
$env:CMAKE_PREFIX_PATH="C:\Qt\5.15.2\msvc2019_64"
|
||
```
|
||
|
||
也可以配置更精确的 `Qt5_DIR`：
|
||
|
||
```powershell
|
||
[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 默认放在：
|
||
|
||
```text
|
||
thirdparty/OpenSSL-Win64
|
||
```
|
||
|
||
推荐目录结构：
|
||
|
||
```text
|
||
thirdparty/
|
||
OpenSSL-Win64/
|
||
include/
|
||
openssl/
|
||
lib/
|
||
VC/
|
||
x64/
|
||
MD/
|
||
MDd/
|
||
```
|
||
|
||
复制命令示例：
|
||
|
||
```powershell
|
||
cd C:\Users\admin\Desktop\update-client
|
||
mkdir thirdparty
|
||
Copy-Item "C:\Program Files\OpenSSL-Win64" ".\thirdparty\OpenSSL-Win64" -Recurse
|
||
```
|
||
|
||
如果 OpenSSL 不放在 `thirdparty/`，可以在配置 CMake 时手动指定：
|
||
|
||
```powershell
|
||
cmake -S . -B out\build\x64-Debug `
|
||
-G "Visual Studio 17 2022" `
|
||
-A x64 `
|
||
-DSIMCAE_OPENSSL_ROOT="C:\Program Files\OpenSSL-Win64"
|
||
```
|
||
|
||
## 3. 重新配置和编译
|
||
|
||
如果之前配置过 CMake，建议先删除旧缓存：
|
||
|
||
```powershell
|
||
cd C:\Users\admin\Desktop\update-client
|
||
Remove-Item out\build -Recurse -Force
|
||
```
|
||
|
||
重新配置：
|
||
|
||
```powershell
|
||
cmake -S . -B out\build\x64-Debug `
|
||
-G "Visual Studio 17 2022" `
|
||
-A x64
|
||
```
|
||
|
||
编译：
|
||
|
||
```powershell
|
||
cmake --build out\build\x64-Debug --config Debug
|
||
```
|
||
|
||
## 4. 提交注意事项
|
||
|
||
不要提交下面这些内容：
|
||
|
||
```text
|
||
thirdparty/
|
||
.vs/
|
||
out/
|
||
build/
|
||
dist/
|
||
App/
|
||
*.exe
|
||
*.dll
|
||
*.lib
|
||
*.pdb
|
||
```
|
||
|
||
这些都属于本机依赖、构建产物或打包产物，不应该进 Git。
|