CMake调库

您说得对！让我重新整理，将同类型的库合并介绍，让结构更清晰。

CMake中的库类型完整分类

1. Header-Only库（纯头文件库）

特点

• 所有代码都在头文件中
• 编译时直接内联
• 不需要链接库文件

项目中的使用

# 设置包含路径
include_directories(external/cpp-httplib)        # httplib.h
include_directories(external/websocketpp)        # websocketpp头文件
include_directories(external/json-develop/include) # json.hpp

# 在源文件中直接包含
#include "httplib.h"
#include <websocketpp/...>
#include <nlohmann/json.hpp>

其他Header-Only库示例

# 更多Header-Only库
include_directories(external/spdlog)      # 日志库
include_directories(external/fmt)         # 格式化库
include_directories(external/catch2)      # 测试框架

2. 预编译库（系统库 + 第三方库）

特点

• 已编译的二进制文件
• 需要链接到可执行文件
• 包含头文件和库文件

项目中的使用

# 查找系统库
find_package(Threads REQUIRED)           # pthread
find_package(OpenSSL 3.0.0 REQUIRED)    # libssl, libcrypto
find_package(Boost COMPONENTS system thread REQUIRED)

# 链接预编译库
target_link_libraries(chat_server
    ${CMAKE_THREAD_LIBS_INIT}    # 系统线程库
    ${OPENSSL_LIBRARIES}         # OpenSSL库
    ${Boost_LIBRARIES}           # Boost库
    uuid                         # 系统UUID库
    stdc++fs                     # C++文件系统库
)

预编译库的完整分类

A. 系统库

# 操作系统提供的库
target_link_libraries(chat_server
    pthread      # POSIX线程库
    uuid         # UUID生成库
    stdc++fs     # C++文件系统库
    rt           # 实时扩展库
    dl           # 动态加载库
)

B. 第三方库

# 通过find_package查找的库
find_package(OpenSSL REQUIRED)
find_package(Boost REQUIRED)
find_package(Qt5 REQUIRED)

target_link_libraries(chat_server
    ${OPENSSL_LIBRARIES}
    ${Boost_LIBRARIES}
    ${Qt5_LIBRARIES}
)

C. 平台特定库

# Windows
if(WIN32)
    target_link_libraries(chat_server
        ws2_32        # Windows Socket
        iphlpapi      # IP Helper
        crypt32       # Crypto API
    )
endif()

# macOS
if(APPLE)
    target_link_libraries(chat_server
        "-framework Foundation"
        "-framework Security"
    )
endif()

3. 自建库（项目内部库）

特点

• 项目内部创建的库
• 模块化代码组织
• 可控制编译选项

创建和使用

# 创建静态库
add_library(common_lib STATIC
    src/common/utils.cpp
    src/common/logger.cpp
)

# 创建动态库
add_library(shared_lib SHARED
    src/shared/network.cpp
    src/shared/protocol.cpp
)

# 链接自建库
target_link_libraries(chat_server
    common_lib
    shared_lib
)

4. 特殊库类型

A. 导入库（外部预编译库）

第三方只提供了库文件和头文件

# 导入外部库
add_library(external_lib IMPORTED)
set_target_properties(external_lib PROPERTIES
	# 设置库的路径
    IMPORTED_LOCATION /path/to/libexternal.so
    # 设置库对应头文件的路径
    IMPORTED_INCLUDE_DIRS /path/to/include
)

target_link_libraries(chat_server external_lib)

B. 接口库（头文件库包装）

# 创建接口库
add_library(header_wrapper INTERFACE)
target_include_directories(header_wrapper INTERFACE
    external/some_header_only_lib
)

target_link_libraries(chat_server header_wrapper)

C. 对象库（编译但不链接）

# 创建对象库
add_library(obj_lib OBJECT src1.cpp src2.cpp)
target_link_libraries(chat_server $<TARGET_OBJECTS:obj_lib>)

5. 库的链接方式总结

Header-Only库

# 只需要设置包含路径
include_directories(external/header_only_lib)
#include "header_only_lib.h"

预编译库

# 需要查找、链接和设置包含路径
find_package(SomeLib REQUIRED)
target_link_libraries(target ${SOMELIB_LIBRARIES})
target_include_directories(target PRIVATE ${SOMELIB_INCLUDE_DIRS})

自建库

# 创建库并链接
add_library(my_lib src/lib.cpp)
target_link_libraries(target my_lib)

6. 项目中的完整库处理流程

# 1. Header-Only库：设置包含路径
include_directories(external/cpp-httplib)
include_directories(external/websocketpp)
include_directories(external/json-develop/include)

# 2. 预编译库：查找系统库
find_package(Threads REQUIRED)
find_package(OpenSSL 3.0.0 REQUIRED)
find_package(Boost COMPONENTS system thread REQUIRED)

# 3. 创建可执行文件
add_executable(chat_server ${SERVER_SOURCES})

# 4. 链接预编译库
target_link_libraries(chat_server
    ${CMAKE_THREAD_LIBS_INIT}    # 系统线程库
    ${OPENSSL_LIBRARIES}         # OpenSSL库
    ${Boost_LIBRARIES}           # Boost库
    uuid                         # 系统UUID库
    stdc++fs                     # C++文件系统库
)

# 5. 设置包含目录
target_include_directories(chat_server PRIVATE
    ${CMAKE_CURRENT_SOURCE_DIR}/src/server
    ${CMAKE_CURRENT_SOURCE_DIR}/src/common
    ${OPENSSL_INCLUDE_DIR}       # OpenSSL头文件
    ${Boost_INCLUDE_DIRS}        # Boost头文件
)

7. 库类型选择指南

库类型	使用场景	优势	劣势
Header-Only库	小型工具库、模板库	简单、无依赖	编译时间长、二进制大
预编译库	大型库、系统库	性能好、编译快	依赖管理复杂
自建库	项目模块化	完全控制、易调试	增加构建复杂度

这样的分类让库的管理更加清晰，每种类型都有其特定的使用场景和优势。