Windows下编译ZLMediaKit：使用vcpkg解决WebRTC的OpenSSL与libSRTP依赖

在 Windows 平台上为流媒体项目 ZLMediaKit 编译并启用 WebRTC 功能时，需要解决其核心依赖，尤其是 OpenSSL 和 libSRTP。手动管理这些依赖库的版本和编译选项较为繁琐，而使用微软的 vcpkg C++ 包管理器可以极大简化这一过程。本文将手把手演示如何通过 vcpkg 安装所需依赖，并成功配置和编译 ZLMediaKit。

第一步：获取并初始化 vcpkg

首先，我们需要获取 vcpkg 并将其初始化（Bootstrap）为可执行工具。打开 PowerShell 或命令提示符，执行以下命令：

git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
.\bootstrap-vcpkg.bat

执行 .\bootstrap-vcpkg.bat 后，你会看到类似下图的输出，表示正在下载并验证 vcpkg 可执行文件：

这个过程完成后，当前目录下就会生成 vcpkg.exe 文件，它是我们后续安装依赖的核心工具。

第二步：安装 WebRTC 所需的依赖包

ZLMediaKit 的 WebRTC 功能主要依赖 openssl 和 libsrtp 这两个库。使用 vcpkg 安装它们非常简单，一条命令即可搞定。请确保你在 vcpkg 的根目录下执行：

1. 安装 OpenSSL：
   这个库为 WebRTC 提供安全的传输通道。

   .\vcpkg install openssl:x64-windows

   安装时，vcpkg 会自动计算安装计划，并处理所有子依赖。下图展示了安装 OpenSSL 时终端的典型输出：
   

2. 安装 libSRTP：
   这是安全实时传输协议库，是 WebRTC 的基石之一。

   .\vcpkg install libsrtp:x64-windows

   同样，安装过程是自动化的，如下图所示：
   

注意：这里的 x64-windows 是目标三元组（Triplet），指定为 64 位的 Windows 库。如果你的开发环境是 32 位，需要替换为 x86-windows。安装过程可能需要一些时间，因为 vcpkg 会从源码编译这些库。

第三步：配置与编译 ZLMediaKit

依赖准备就绪后，就可以编译 ZLMediaKit 了。首先，请将 ZLMediaKit 的源码克隆到本地（假设与 vcpkg 目录在同一父目录下）：

cd ..
git clone https://github.com/ZLMediaKit/ZLMediaKit.git
cd ZLMediaKit
git submodule update --init

接下来，创建一个构建目录并使用 CMake 生成项目文件。这是最关键的一步，需要将 vcpkg 的工具链文件路径正确传递给 CMake。

1. 创建构建目录并进入：

   mkdir build
   cd build

2. 运行 CMake 配置命令：
   你需要根据自己电脑上 CMake 和 vcpkg 的实际路径来调整以下命令。命令的核心是：

   • -DCMAKE_TOOLCHAIN_FILE=...：指定 vcpkg 的工具链文件，这是让 CMake 找到 vcpkg 所安装库的关键。
   • -DENABLE_WEBRTC=ON：显式启用 WebRTC 功能。
   • -DENABLE_OPENSSL=ON：显式启用 OpenSSL。

   假设你的 vcpkg 克隆在 D:\git_code\zlm\vcpkg，CMake 命令示例如下：

   & "C:\Program Files\CMake\bin\cmake.exe" .. -DCMAKE_TOOLCHAIN_FILE="D:/git_code/zlm/vcpkg/scripts/buildsystems/vcpkg.cmake" -DENABLE_WEBRTC=ON -DENABLE_OPENSSL=ON

   执行成功后，终端会输出一系列配置信息，并列出已找到的依赖库，如下图，这表明 CMake 已经成功通过 vcpkg 定位到了我们安装的 OpenSSL 和 libSRTP：
   

3. 编译项目：
   使用你习惯的构建工具进行编译。如果你使用 Visual Studio 的 msbuild，可以执行：

   msbuild ZLMediaKit.sln -p:Configuration=Release -m

   或者直接打开生成的 ZLMediaKit.sln 在 Visual Studio IDE 中编译。编译过程可能会持续一段时间，并出现一些警告，这通常是正常的。最终，你应该看到“生成成功”的提示，类似下图：
   

第四步：验证成果

编译完成后，你可以在输出目录（例如 ./release/windows/Release/）找到 MediaServer.exe 以及相关的动态库（如 libcrypto-3-x64.dll, libssl-3-x64.dll, srtp2.dll）。运行 MediaServer.exe，如果服务正常启动且日志中没有出现因缺少 openssl 或 libsrtp 而导致的错误，就说明我们已成功编译出支持 WebRTC 功能的 ZLMediaKit。

整个过程可以总结为下图所示的几个清晰步骤：

总结

通过 vcpkg 来管理 C++ 项目的第三方依赖，特别是在 Windows 平台，能够有效避免“依赖地狱”。本文演示的方法不仅适用于 ZLMediaKit，其思路也适用于任何其他需要复杂依赖的 C/C++ 项目。对于从事流媒体、WebRTC 开发的工程师来说，掌握 vcpkg 和 CMake 的协同工作流程，是提升开发效率的重要一环。如果你在实践过程中遇到其他问题，或者想了解更多关于项目构建和依赖管理的知识，欢迎在 云栈社区 的技术板块进行交流探讨。