Windows 系统上使用 CMake 编译和链接 OpenSSL 的完整指南

在 Windows 上使用 CMake 编译和链接 OpenSSL 的终极指南

简介

在 Windows 系统上使用 CMake 编译和链接 OpenSSL 可能会带来一些挑战。本指南将详细介绍解决这些挑战所需的步骤，帮助你成功构建你的项目。

先决条件

• 安装 CMake（版本 3.28.3 或更高）
• 安装 OpenSSL（版本 3.2.1 或更高）

设置 CMakeLists.txt

在你的 CMakeLists.txt 文件中，添加以下行以查找 OpenSSL：

find_package(OpenSSL REQUIRED)

设置 OPENSSL_ROOT_DIR

由于 CMake 无法自动检测 OpenSSL 的安装路径，你需要手动设置 OPENSSL_ROOT_DIR 环境变量。

1. 打开控制面板并转到 "系统和安全" > "系统"。
2. 在左侧栏中，单击 "高级系统设置"。
3. 在 "环境变量" 部分，在 "系统变量" 列表中找到 "Path" 变量。
4. 单击 "编辑"，然后在变量值末尾添加以下路径：

;C:\Program Files\OpenSSL-Win64\bin

确保使用分号 (;) 将此路径与现有的路径分隔开。

重新生成 CMake

1. 删除 CMake 缓存：

cmake --clean-directory <你的构建目录>

2. 重新运行 CMake：

cmake <你的源目录>

检查输出

CMake 现在应该能够找到 OpenSSL。检查输出，确保已找到 "OPENSSL_ROOT_DIR" 变量：

-- Found OpenSSL: C:/Program Files/OpenSSL-Win64/lib/libcrypto-3-x64.dll (found version "3.2.1")

编译和链接

按照通常的方式编译和链接你的项目。例如：

cmake --build <你的构建目录>

其他提示

• 如果 curl 也存在问题，请尝试使用与 OpenSSL 相同的方法设置 CURL_ROOT_DIR 环境变量。
• 确保你的 OpenSSL 和 CMake 版本与指南中指定的版本匹配。
• 检查你的代码是否正确包含了 OpenSSL 库。
• 查看 GitHub Actions 的文档以获取在 Windows 上构建项目的任何特定说明。

常见问题解答

1. 为什么我无法找到 OpenSSL？

确保你已正确安装 OpenSSL，并且已将 OPENSSL_ROOT_DIR 环境变量设置到正确的安装路径。

2. 为什么 CMake 仍然找不到 OpenSSL？

检查你的 CMakeLists.txt 文件是否包含 find_package(OpenSSL REQUIRED) 行。确保你的 OpenSSL 安装路径可由 CMake 访问。

3. 如何处理 curl 链接错误？

使用与 OpenSSL 相同的方法设置 CURL_ROOT_DIR 环境变量。

4. 如何解决版本不匹配错误？

确保你的 OpenSSL 和 CMake 版本与指南中指定的版本匹配。

5. 为什么我的项目无法编译或链接？

检查你的代码是否正确包含了 OpenSSL 库，并且你已正确设置了环境变量。

结论

遵循本指南中的步骤，你将能够在 Windows 系统上使用 CMake 编译和链接 OpenSSL。希望这有助于你成功构建你的项目。