【AI大模型接入SDK】ChatSDK：CMake构建静态库完整实现

艾莉丝努力练剑2026-10-01 8:41

🎬 个人主页 ：艾莉丝努力练剑
❄专栏传送门 ：《C语言》《数据结构与算法》《C/C++干货分享&学习过程记录》
《Linux操作系统编程详解》《笔试/面试常见算法：从基础到进阶》《Python干货分享》

⭐️为天地立心，为生民立命，为往圣继绝学，为万世开太平

🎬 艾莉丝的简介：

文章目录

  • [1 ~> ChatSDK CMake 构建静态库完整实现](#1 ~> ChatSDK CMake 构建静态库完整实现)
    • [1.1 业务目标](#1.1 业务目标)
    • [1.2 两种源文件管理方式](#1.2 两种源文件管理方式)
      • [1.2.1 手动枚举源文件](#1.2.1 手动枚举源文件)
      • [1.2.2 file (GLOB_RECURSE) 自动收集源码](#1.2.2 file (GLOB_RECURSE) 自动收集源码)
    • [1.3 sdk/CMakeLists.txt 完整正确代码](#1.3 sdk/CMakeLists.txt 完整正确代码)
    • [1.4 关键依赖宏：CPPHTTPLIB_OPENSSL_SUPPORT](#1.4 关键依赖宏：CPPHTTPLIB_OPENSSL_SUPPORT)
    • [1.5 编译与安装完整 shell 操作流程](#1.5 编译与安装完整 shell 操作流程)
    • [1.6 常见报错与排错](#1.6 常见报错与排错)
      • [1.6.1 报错：`OpenSSL::SSL target was not found`](#1.6.1 报错：OpenSSL::SSL target was not found)
      • [1.6.2 cmake 警告：`cmake_minimum_required should be called prior to project()`](#1.6.2 cmake 警告：cmake_minimum_required should be called prior to project())
      • [1.6.3 权限拒绝 Permission denied](#1.6.3 权限拒绝 Permission denied)
      • [1.6.4 GLOB_RECURSE 新增源码不编译](#1.6.4 GLOB_RECURSE 新增源码不编译)
    • [1.7 SDK 对外使用说明](#1.7 SDK 对外使用说明)
    • [1.8 核心概念补充](#1.8 核心概念补充)
      • [1.8.1 PUBLIC / PRIVATE / INTERFACE](#1.8.1 PUBLIC / PRIVATE / INTERFACE)
      • [1.8.2 install 参数释义](#1.8.2 install 参数释义)
      • [1.8.3 静态库本质](#1.8.3 静态库本质)
  • 结尾

1 ~> ChatSDK CMake 构建静态库完整实现

1.1 业务目标

  • 将 ChatSDK 编译为Linux 静态库（.a），对外交付产物为：头文件 + 静态库文件。
  • 通过make install将库与头文件安装至系统目录/usr/local，实现全局可被其他项目直接引用。
  • SDK 目录结构
bash 复制代码 
sdk
├─ CMakeLists.txt   # SDK的CMake构建脚本
├─ include          # 对外头文件
│  ├─ util
│  ├─ ChatGPTProvider.h
│  ├─ ChatSDK.h
│  ├─ common.h
│  ├─ DataManager.h
│  ├─ DeepSeekProvider.h
│  ├─ GeminiProvider.h
│  ├─ LLMManager.h
│  ├─ LLMProvider.h
│  ├─ OllamaLLMProvider.h
│  └─ SessionManager.h
└─ src              # 实现源文件
   ├─ util
   ├─ ChatGPTProvider.cpp
   ├─ ChatSDK.cpp
   ├─ DataManager.cpp
   ├─ DeepSeekProvider.cpp
   ├─ GeminiProvider.cpp
   ├─ LLMManager.cpp
   ├─ OllamaLLMProvider.cpp
   └─ SessionManager.cpp

1.2 两种源文件管理方式

1.2.1 手动枚举源文件

  • 原理：在add_executable / add_library中显式罗列全部.cpp源码。
  • 优点：编译文件清单清晰可控。
  • 缺点：新增.cpp源文件必须手动修改 CMakeLists.txt 添加，遗忘会导致新增文件不参与编译。
bash 复制代码 
add_executable(testLLM
    testLLM.cpp
    ../sdk/src/util/myLog.cpp
    ../sdk/src/DeepSeekProvider.cpp
    ../sdk/src/ChatGPTProvider.cpp
    ../sdk/src/GeminiProvider.cpp
    ../sdk/src/OllamaLLMProvider.cpp
    ../sdk/src/DataManager.cpp
    ../sdk/src/SessionManager.cpp
    ../sdk/src/LLMManager.cpp
    ../sdk/src/ChatSDK.cpp
)

1.2.2 file (GLOB_RECURSE) 自动收集源码

  • 原理：递归遍历指定目录，通配符匹配后缀文件，存入 CMake 变量。

注意：GLOB 不会监测磁盘文件变更，新增源文件需要重新执行cmake ..才会被识别。

cmake 复制代码 
# 递归收集src目录所有cpp源文件
file(GLOB_RECURSE SDK_SOURCES "src/*.cpp")
# 递归收集include目录所有h头文件
file(GLOB_RECURSE SDK_HEADERS "include/*.h")

1.3 sdk/CMakeLists.txt 完整正确代码

bash 复制代码 
# CMake最低版本约束，必须放在文件最开头
cmake_minimum_required(VERSION 3.10)

# 项目定义
project(ai_chat_sdk)

# SDK名称变量
set(SDK_NAME "ai_chat_sdk")

# C++标准配置
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 构建类型：Release发布版本
set(CMAKE_BUILD_TYPE Release)

# 递归收集源码与头文件
file(GLOB_RECURSE SDK_SOURCES "src/*.cpp")
file(GLOB_RECURSE SDK_HEADERS "include/*.h")

# 生成静态库 STATIC代表静态库
add_library(${SDK_NAME} STATIC
    ${SDK_SOURCES}
    ${SDK_HEADERS}
)

# 设置编译产物输出目录
set(EXECUTABLE_OUTPUT_PATH ${CMAKE_CURRENT_SOURCE_DIR}/build)

# 头文件搜索路径 PUBLIC：使用者也会继承该头文件路径
target_include_directories(${SDK_NAME} PUBLIC
    ${CMAKE_CURRENT_SOURCE_DIR}/include
)

# HTTPS支持宏定义，启用cpp‑httplib的OpenSSL能力
target_compile_definitions(${SDK_NAME} PUBLIC
    CPPHTTPLIB_OPENSSL_SUPPORT
)

# 查找OpenSSL依赖
find_package(OpenSSL REQUIRED)

# 第三方库搜索路径
link_directories(/usr/local/lib)

# 链接依赖库
target_link_libraries(${SDK_NAME}
    jsoncpp
    fmt
    spdlog
    sqlite3
    OpenSSL::SSL
    OpenSSL::Crypto
)

########## install安装规则 make install执行时生效 ##########
# 安装静态库 ARCHIVE专门用于静态库
install(TARGETS ${SDK_NAME}
    ARCHIVE DESTINATION lib
)

# 批量安装头文件，复制到/usr/local/include/ai_chat_sdk
install(DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/include/
    DESTINATION include/ai_chat_sdk
    FILES_MATCHING PATTERN "*.h"
)
  • 关键字说明
    • add_library(xxx STATIC)：构建静态库，产物lib${SDK_NAME}.a。
    • target_include_directories PUBLIC：本库编译、外部使用者编译均可看到该头文件目录；PRIVATE 仅本项目内部生效。
    • target_compile_definitions PUBLIC：宏定义会传递给链接本 SDK 的上层项目。
    • install TARGETS ... ARCHIVE DESTINATION lib：静态库安装到${CMAKE_INSTALL_PREFIX}/lib，默认CMAKE_INSTALL_PREFIX=/usr/local。
    • install DIRECTORY：批量复制 include 下全部.h到系统 include 子目录。

1.4 关键依赖宏：CPPHTTPLIB_OPENSSL_SUPPORT

  • cpp‑httplib 库，默认仅支持 HTTP；开启该宏，才会引入 OpenSSL 头文件，启用 HTTPS 能力。
  • 源码逻辑：#ifdef CPPHTTPLIB_OPENSSL_SUPPORT分支内才会#include <openssl/xxx>。
  • 宏必须通过target_compile_definitions定义，不能写在代码内。

1.5 编译与安装完整 shell 操作流程

bash 复制代码 
# 进入sdk源码目录
cd sdk
# 创建构建目录
mkdir build
cd build
# cmake解析构建脚本
cmake ..
# 编译生成静态库libai_chat_sdk.a
make
# 安装到系统目录，修改/usr/local需要root权限
sudo make install
  • 安装完成产物位置
    • 静态库：/usr/local/lib/libai_chat_sdk.a
    • 头文件：/usr/local/include/ai_chat_sdk/

1.6 常见报错与排错

1.6.1 报错：OpenSSL::SSL target was not found

  • 根因：find_package(OpenSSL REQUIRED)调用缺失，找不到导入目标OpenSSL::SSL。
  • 修复：CMake 脚本中添加find_package(OpenSSL REQUIRED)，放在使用OpenSSL::SSL之前。

1.6.2 cmake 警告：cmake_minimum_required should be called prior to project()

  • 根因：cmake_minimum_required()写在了project()之后。
  • 修复：文件第一行必须写 cmake_minimum_required，再写 project 指令。

1.6.3 权限拒绝 Permission denied

  • 现象：直接make install写/usr/local失败。
  • 解决方案：使用sudo make install提升权限执行安装。

1.6.4 GLOB_RECURSE 新增源码不编译

  • 根因：file (GLOB_RECURSE 仅 cmake 解析阶段扫描一次磁盘，后续新增文件不会自动检测。
  • 修复：新增源文件后重新执行cmake ..，再执行 make。

1.7 SDK 对外使用说明

  • 其他开发者使用该 ChatSDK：
    • 获取 SDK 源码。
    • 创建 build 目录执行cmake .. && make && sudo make install。
    • 使用者项目直接#include <ai_chat_sdk/ChatSDK.h>，链接ai_chat_sdk即可。

1.8 核心概念补充

1.8.1 PUBLIC / PRIVATE / INTERFACE

属性 作用域
PRIVATE 仅当前库编译时生效，不会传递给链接者
PUBLIC 当前库 + 所有链接该库的上层项目均生效
INTERFACE 仅链接该库的上层项目生效，本库编译不生效

1.8.2 install 参数释义

  • ARCHIVE DESTINATION lib：专门对应静态库（.a）。
  • LIBRARY DESTINATION lib：专门对应动态库（.so/.dylib）。
  • RUNTIME DESTINATION bin：可执行程序、Windows 下 dll。
  • CMAKE_INSTALL_PREFIX：安装根目录，默认/usr/local，cmake 可通过-DCMAKE_INSTALL_PREFIX=xxx修改安装路径。

1.8.3 静态库本质

  • Linux 静态库.a本质是.o目标文件归档包；链接阶段完整复制库内代码到最终可执行文件。
  • 优点：部署简单，运行时不依赖外部库文件；缺点：可执行文件体积大，库更新需要重新编译链接上层程序。

结尾

uu们，本文的内容到这里就全部结束了，艾莉丝在这里再次感谢您的阅读！

|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ### 艾莉丝努力练剑 C/C++ & Linux 底层探索者 | 一个正在努力练剑的技术博主 *** ** * ** *** 👀 【关注】 跟随我一起深耕技术领域，见证每一次成长。 ❤️ 【点赞】 让优质内容被更多人看见，让知识传递更有力量。 ⭐ 【收藏】 把核心知识点存好，在需要时随时查、随时用。 💬 【评论】 分享你的经验或疑问，评论区一起交流避坑！ 不要忘记给博主"一键四连"哦！ "今日练剑达成！" "技术之路难免有困惑，但同行的人会让前进更有方向。" |

结语：希望对学习Linux相关内容的uu有所帮助，不要忘记给博主"一键四连"哦！

往期回顾：

【AI大模型接入SDK】ChatSDK 集成测试概述

🗡博主在这里放了一只小狗，大家看完了摸摸小狗放松一下吧！🗡 ૮₍ ˶ ˊ ᴥ ˋ˶₎ა

相关推荐
百度一下吧1 小时前
umi后台管理项目实战：从工程搭建到生产构建
java·前端·javascript
YFJ_mily1 小时前
二轮截稿延期｜BDAIA2026第三届大数据分析与人工智能应用｜往届会后两月见刊 IEEE出版 EI&Scopus检索
人工智能·数据挖掘·数据分析·大数据分析·rdlink研发家·大语言模型与智能体·ai系统安全风险评估
haerapi1 小时前
仓库拣货路线不只靠最短边：S 形启发式的反例记录
android·开发语言·javascript
易天ETU1 小时前
PCB与AI浪潮的关联性《补充篇》
网络·人工智能·光模块·光通信·易天光通信
GEO实战经验分享1 小时前
LLM-First Search可复现性：环境、任务、版本与假设缺一不可
大数据·人工智能·安全·chatgpt
Joe_Wang51 小时前
【从0到1学习JVM · 14】堆内存各区域分工与Xms和Xmx设为一样的真相
java·jvm·学习·垃圾回收
AI创界者1 小时前
Python 进阶：重构经典设计模式（五）—— 状态模式与观察者模式在 Python 3.10+ 中的类型驱动与事件解耦
人工智能·aigc
不开大的凯20771 小时前
AI的“迷惑行为大赏”
人工智能·ai
陈童学哦1 小时前
本地小模型实战：商城客服消息分流，2款模型硬碰硬
人工智能
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02历年考研数学一、数学二、数学三真题试卷及答案PDF03GitHub 镜像站点04Telegram APK 下载安装完整指南 — 2026年最新05蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接062026 爱知・名古屋亚运会怎么看？直播平台+赛程安排分享07微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新08jev-ultrafast 深度解析：7 秒订机票的浏览器 Agent 是如何炼成的09给AI一张“业务概念地图“：本体如何从哲学走向企业智能10Windows 10/11 如何退出微软账户并改用本地账户登录（含找不到选项的解决方法）