4. 开发环境搭建：操作系统依赖、编译器配置、SDK库编译与安装

说实话，开发环境这块我吃过不少亏。早年有个项目，明明代码写好了，结果同事的机器上编译死活过不去，最后发现是操作系统版本差了半个小版本，openssl库的符号不一样。从那以后，我习惯把环境搭建写成可重复的脚本，省得大家踩坑。

这一章咱们就自底向上，把DLP与加密SDK的编译环境捋清楚。你跟着走一遍，后面集成的时候会顺畅很多。

4.1 操作系统依赖

DLP与加密SDK主要依赖Linux系统，我推荐用 Ubuntu 20.04 LTS 或 CentOS 7.9。这两套系统在服务器市场覆盖率最高，社区支持也最成熟。

你需要确认以下基本依赖已经安装：

• gcc / g++ (版本 ≥ 9.3)
• cmake (版本 ≥ 3.18)
• make / ninja-build
• libssl-dev (OpenSSL 1.1.1 或更高)
• libcurl4-openssl-dev
• libpcre3-dev (正则表达式解析)
• libxml2-dev (XML配置解析)
• uuid-dev (UUID生成)

我习惯先跑一个快速检查脚本：

#!/bin/bash
# check_env.sh
echo "=== 检查 C++ 编译器 ==="
g++ --version | head -n1
echo "=== 检查 cmake ==="
cmake --version | head -n1
echo "=== 检查 OpenSSL ==="
openssl version | head -n1
echo "=== 检查关键库头文件 ==="
dpkg -l | grep -E "libssl-dev|libcurl4-openssl-dev|libpcre3-dev|libxml2-dev|uuid-dev"

4.2 编译器配置

我们SDK用C++17标准写，所以编译器必须支持C++17。GCC 9.3以上都没问题。我记得有一次项目组有人用GCC 8，编译时一堆模板报错，最后发现是 std::any 的完整实现需要GCC 9+。嗯，直接升级省心。

如果你系统自带的GCC版本太老，可以用以下方式升级：

# Ubuntu 20.04
sudo apt install gcc-9 g++-9
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 90
sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-9 90

# CentOS 7 需要先安装 devtoolset-9
sudo yum install centos-release-scl
sudo yum install devtoolset-9-gcc-c++
scl enable devtoolset-9 bash

配置完成后，记得确认默认版本：

gcc --version | grep "gcc (GCC)"   # 输出应该是 9.3.x 或更高

if(CMAKE_CXX_COMPILER_VERSION VERSION_LESS 9.3)
  message(FATAL_ERROR "GCC >= 9.3 required, got ${CMAKE_CXX_COMPILER_VERSION}")
endif()

4.3 SDK库的编译与安装

拿到SDK源码包（通常是一个 .tar.gz 或 git clone），接下来就是标准的CMake三步走。我先给你个总览图，心里有个底：

具体操作步骤：

1. 解压源码（或 git clone）。假设放在 /opt/dlp_sdk。
2. 创建独立构建目录——这点我特别坚持。直接在源码目录编译会污染源码树，未来切换配置麻烦。

mkdir build && cd build
cmake .. \
  -DCMAKE_INSTALL_PREFIX=/usr/local \
  -DCMAKE_BUILD_TYPE=Release \
  -DUSE_OPENSSL=ON \
  -DUSE_CURL=ON

3. 编译。可以用 -j$(nproc) 并行加速：

make -j$(nproc)
# 如果看到 100% 进度，没报错，就成功了

4. 安装：

sudo make install

安装完成后，库文件会被拷贝到 ${PREFIX}/lib，头文件到 ${PREFIX}/include，可执行示例到 ${PREFIX}/bin。

4.4 验证安装

别急着跑。我曾经在安装后忘了更新动态库缓存，导致链接失败。所以最后一步：

sudo ldconfig
# 检查库是否被找到
ldconfig -p | grep dlp_sdk

然后写个最简单的测试程序：

// test_dlp.cpp
#include <dlp_sdk/dlp.h>
int main() {
    std::cout << "DLP SDK version: " << dlp::getVersion() << std::endl;
    return 0;
}

g++ test_dlp.cpp -ldlp_sdk -o test_dlp
./test_dlp
# 应该输出类似 "DLP SDK version: 2.1.0"

4.5 常见问题与避坑