CMake工程中引入其他C++三方库，包管理

原创 已于 2025-07-18 15:50:32 修改 · 1.1k 阅读 · 16 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#c++ #开发语言 #android

于 2025-03-27 21:00:42 首次发布

在Android NDK CMake工程中引入其他C++三方库时，有以下几种常见的依赖方式：

1. 源码依赖

如果三方库的源代码包含在你的项目目录中，并且它有自己的CMake配置，可以使用add_subdirectory将三方库的构建过程集成到你的项目中。

示例：

假设三方库的源代码位于third_party/SomeLibrary目录下。

# CMakeLists.txt

# 添加三方库的构建
add_subdirectory(third_party/SomeLibrary)

# 添加可执行文件目标
add_library(native-lib SHARED native-lib.cpp)

# 将三方库链接到目标
target_link_libraries(native-lib PRIVATE SomeLibrary)

2. 预编译库依赖

如果三方库已经预先编译成.so或.a文件，可以使用add_library和target_link_libraries来引入这些预编译库。
适用场景：第三方库已提供针对 Android 的预编译动态库（.so）和头文件。

示例：

假设三方库的预编译.so文件位于libs/${ANDROID_ABI}/libSomeLibrary.so。

# CMakeLists.txt

# 添加预编译库
add_library(SomeLibrary SHARED IMPORTED)
set_target_properties(SomeLibrary PROPERTIES IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/libs/${ANDROID_ABI}/libSomeLibrary.so)

# 添加可执行文件目标
add_library(native-lib SHARED native-lib.cpp)

# 将预编译库链接到目标
target_link_libraries(native-lib PRIVATE SomeLibrary)
方式 1：预编译动态库（.so）

步骤：

  1. 放置文件：

    • 将 .so 文件按 ABI 分类放入 src/main/jniLibs/abi/ 目录（如 armeabi-v7a/libmylib.so）。
    • 将头文件放入 src/main/cpp/include/ 目录。

  2. 配置 CMakeLists.txt：

    # 设置头文件路径
include_directories(src/main/cpp/include)

# 导入动态库（以 openssl 为例）
add_library(openssl SHARED IMPORTED)
set_target_properties(openssl PROPERTIES
    IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/src/main/jniLibs/${ANDROID_ABI}/libssl.so
)

# 添加自己的目标（如共享库）
add_library(native-lib SHARED
    src/main/cpp/native-lib.cpp
)

# 链接第三方库和系统库（如 log）
target_link_libraries(native-lib
    openssl
    log  # Android 系统日志库
)
方式 2：预编译静态库（.a）

步骤：

  1. 放置文件：

    • 将 .a 文件放入 src/main/jniLibs/abi/ 目录。
    • 头文件放入 src/main/cpp/include/。

  2. 配置 CMakeLists.txt：

    # 导入静态库（如 libpng）
add_library(png STATIC IMPORTED)
set_target_properties(png PROPERTIES
    IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/src/main/jniLibs/${ANDROID_ABI}/libpng.a
)

# 链接静态库
target_link_libraries(native-lib
    png
    log
)

3. 使用FetchContent模块（CMake 3.11+）

如果三方库可以从远程位置（如Git仓库）获取，可以使用FetchContent模块在构建过程中自动下载和构建三方库。

示例：

假设三方库的Git地址为https://github.com/someuser/SomeLibrary.git。

# CMakeLists.txt

# 启用FetchContent模块
include(FetchContent)

# 下载并构建三方库
FetchContent_Declare(
    SomeLibrary
    GIT_REPOSITORY https://github.com/someuser/SomeLibrary.git
    GIT_TAG        main
)
FetchContent_MakeAvailable(SomeLibrary)

# 添加可执行文件目标
add_library(native-lib SHARED native-lib.cpp)

# 将三方库链接到目标
target_link_libraries(native-lib PRIVATE SomeLibrary)

4. 手动指定源文件

如果三方库的源代码是一个简单的库，没有复杂的构建系统，可以直接将源文件添加到你的CMake工程中。

示例：

假设三方库的源文件位于third_party/SomeLibrary/src目录下，头文件位于third_party/SomeLibrary/include目录下。

# CMakeLists.txt

# 添加三方库的源文件
add_library(SomeLibrary STATIC)
target_sources(SomeLibrary PRIVATE
    third_party/SomeLibrary/src/file1.cpp
    third_party/SomeLibrary/src/file2.cpp
)
target_include_directories(SomeLibrary PRIVATE
    third_party/SomeLibrary/include
)

# 添加可执行文件目标
add_library(native-lib SHARED native-lib.cpp)

# 将三方库链接到目标
target_link_libraries(native-lib PRIVATE SomeLibrary)

步骤：

  1. 将源码放入项目目录：

    • 将第三方库的源码放在 thirdparty/ 目录下（如 thirdparty/openssl）。

  2. 配置 CMakeLists.txt：

    # 将第三方库的源码目录加入子目录编译
add_subdirectory(${CMAKE_SOURCE_DIR}/thirdparty/openssl)

# 添加自己的目标
add_library(native-lib SHARED src/main/cpp/native-lib.cpp)

# 链接编译后的库
target_link_libraries(native-lib
    openssl  # 假设第三方库生成的库名为 openssl
    log
)

5. 使用include_directories指定头文件路径

如果需要引入三方库的头文件，可以使用include_directories指定头文件路径。

示例：

假设三方库的头文件位于third_party/SomeLibrary/include目录下。

# CMakeLists.txt

# 指定头文件路径
include_directories(third_party/SomeLibrary/include)

# 添加可执行文件目标
add_library(native-lib SHARED native-lib.cpp)

# 如果是预编译库，还需要指定库文件路径并链接
# add_library(SomeLibrary SHARED IMPORTED)
# set_target_properties(SomeLibrary PROPERTIES IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/libs/${ANDROID_ABI}/libSomeLibrary.so)
# target_link_libraries(native-lib PRIVATE SomeLibrary)
方式 4：系统库查找（find_package）

步骤：

  1. 确保库已安装：

    • 第三方库需在系统中安装（如通过 NDK 或包管理器安装）。

  2. 配置 CMakeLists.txt：

    # 查找已安装的 OpenCV 库
find_package(OpenCV REQUIRED)

# 添加目标并链接
add_library(native-lib SHARED src/main/cpp/native-lib.cpp)
target_include_directories(native-lib PRIVATE ${OpenCV_INCLUDE_DIRS})
target_link_libraries(native-lib ${OpenCV_LIBS} log)
方式 5：自动下载编译（ExternalProject_Add）

步骤：

  1. 配置 CMakeLists.txt：
    # 下载并编译第三方库（如 gtest）
include(ExternalProject)
ExternalProject_Add(
    gtest
    GIT_REPOSITORY https://github.com/google/googletest.git
    CMAKE_ARGS -DCMAKE_INSTALL_PREFIX=${CMAKE_BINARY_DIR}/gtest
)

# 添加目标并链接
add_library(gtest-lib INTERFACE)
target_include_directories(gtest-lib INTERFACE
    ${CMAKE_BINARY_DIR}/gtest/include
)
target_link_libraries(gtest-lib INTERFACE
    ${CMAKE_BINARY_DIR}/gtest/lib/libgtest.a
)

# 使用 gtest
add_executable(my_test test.cpp)
target_link_libraries(my_test gtest-lib)

关键配置说明

  1. 头文件路径：

    include_directories(  # 传统方式
    src/main/cpp/include
    thirdparty/include
)

# 推荐使用 target_include_directories
target_include_directories(native-lib PRIVATE
    ${CMAKE_SOURCE_DIR}/src/main/cpp/include
)

  2. 动态库路径的动态化：

    • 使用 ${ANDROID_ABI} 变量自动适配不同 ABI：
      set(LIB_DIR ${CMAKE_SOURCE_DIR}/src/main/jniLibs/${ANDROID_ABI})
set_target_properties(png PROPERTIES
    IMPORTED_LOCATION ${LIB_DIR}/libpng.so
)

  3. 依赖传递性：

    • 如果第三方库依赖其他库（如 libcrypto.so），需逐层导入：
      add_library(crypto SHARED IMPORTED)
set_target_properties(crypto PROPERTIES
    IMPORTED_LOCATION ${LIB_DIR}/libcrypto.so
)
target_link_libraries(openssl PRIVATE crypto)  # openssl 依赖 crypto

总结：依赖方式对比

  • 源码依赖：适用于三方库的源代码已经包含在项目目录中，并且有CMake配置。
  • 预编译库依赖：适用于三方库已经预先编译成.so或.a文件。
  • FetchContent：适用于从远程位置获取并自动构建三方库。
  • 手动指定源文件：适用于简单的三方库，直接将源文件添加到工程中。
  • include_directories：适用于需要引入三方库的头文件。
    | 方式 | 是否需要源码 | 适用场景 | 优点 | 缺点 |
    |------------------------|--------------|-----------------------------------|-------------------------------|-------------------------------|
    | 预编译动态库（.so） | 不需要 | 第三方提供预编译动态库 | 快速集成，无需编译 | 需确保 ABI 兼容性 |
    | 预编译静态库（.a） | 不需要 | 第三方提供静态库 | 静态链接，无依赖传递问题 | 文件体积较大 |
    | 源码编译（add_subdirectory） | 需要 | 需自定义编译或库未提供预编译文件 | 灵活配置，支持修改源码 | 需处理交叉编译及依赖 |
    | 系统库（find_package） | 不需要 | 系统已安装且提供 CMake 配置文件 | 自动化配置，简洁 | 依赖系统环境 |
    | 自动下载（ExternalProject） | 需要 | 需自动管理源码下载和编译 | 自动化流程，便于版本控制 | 构建时间较长 |

通过以上方法，可以根据第三方库的提供形式和项目需求，灵活选择最合适的依赖方式。

ref：

https://www.echo.cool/docs/language/cpp/cpp-projects-and-tools/cpp-dependency-management/
http://chu-studio.com/posts/2019/%E4%BB%8E%E9%9B%B6%E5%BC%80%E5%A7%8B%E7%9A%84C++%E5%8C%85%E7%AE%A1%E7%90%86%E5%99%A8CONAN%E4%B8%8A%E6%89%8B%E6%8C%87%E5%8D%97

C++大型项目管理：一文讲透cmake最佳工程实践（可复用）
bigchen
06-22 1467
相比传统CMake，现代CMake强化了模块化、标准化的设计思想，提供了大量基于target的设计模式。核心是Target（构建目标）像编程一样认真对待CMake代码模块化利用CMake提供的Public传播等特性自动管理依赖等关系避免全局更改，而是使用带有作用域的target相关函数CMake项目结构CMakeLists写法参考为了更加方便的引入三方库，现代CMake提供了丰富的工具和规范。
cmake添加第三方库
a15322910600的博客
10-10 3605
主要方法 #将包含目录添加到构建中 include_directories(D:/Download/boost/boost_1_77_0) include_directories(D:/Download/libxlsxwriter/fast_excel-master/libxlsxwriter/include) include_directories(D:/Download/libxlsxwriter/fast_excel-master/libxlsxwriter/src) #此命令用于查找库 find_
如何在cmake项目中引入自定义第三方库
最新发布
qq_40278194的博客
06-12 359
本文介绍了如何为自定义第三方库编写.cmake文件的方法。主要内容包括：1) 设置库的根目录环境变量；2) 编写.cmake文件的关键步骤，如查找库文件、头文件路径，处理不同构建模式的后缀，安装DLL文件等；3) 在主项目中配置自定义模块搜索路径。文章以Windows平台为例，详细说明了如何实现库的自动查找、路径设置和安装部署，并提供了完整的.cmake文件示例和主项目配置示例。该方法适用于需要集成自定义第三方库的CMake项目构建场景。
关于CMake引用第三方动态库依赖的问题
Mario_z的博客
06-04 114
Cmake链接
CMake 引入第三方库
ccsu_zzh的博客
02-18 1万+
CMake如何引入第三方库
【cmake学习】cmake 引入第三方库（头文件目录、库目录、库文件）
热门推荐
challenglistic的博客
02-17 6万+
【cmake学习】cmake 引入第三方库（头文件目录、库目录、库文件）
5.cmake导入第三方库
weixin_38738238的博客
03-22 571
使用第三方库有两种方式，一种是使用cmake文件导入的方式，另一种是使用pc文件导入的方式。
cmake之某个第三方库的引用
hqb_newfarmer的博客
09-23 801
cmake之某个第三方库的引用
cmake-cmake使用示例之三方库.zip
06-15
在"cmake-cmake使用示例之三方库.zip"这个压缩包中，我们可以推测它包含了一些关于如何使用CMake来管理并构建第三方库的示例。这对于我们理解如何在C++项目中集成和管理外部库非常有帮助。C++开发中，经常需要引入第...
cmake：编译动态库/静态库
weiweiqiao的专栏
02-18 272
相较动态链接库，静态库不需要使用导出函数。静态库编译包保存在lib文件夹中。父类，Base_operator.h。子类，Operator.h。
OpenHarmony C/C++三方库移植适配
weixin_66608063的博客
05-27 611
在开发过程中，经常需要将现有的C/C++三方库移植到OpenHarmony平台上。本文将介绍三方库移植适配的一般流程，包括环境准备、库的集成、编译适配以及调试等步骤，并提供示例代码。在实际开发过程中，开发者经常需要将现有的C/C++三方库移植到OpenHarmony上，以复用已有的代码和功能。三方库的移植适配是OpenHarmony开发中的一个重要环节。通过本文的介绍，开发者可以了解三方库移植的基本流程和方法。在实际操作中，可能需要根据具体的库和OpenHarmony的版本进行适当的调整和优化。
鸿蒙OH实战开发：如何将三方库集成到hap包中——通过IDE集成cmak构建方式的C/C++三方库
liuhaojiabin的博客
12-10 469
cmake构建方式是开源三方库的主流构建方式。DevEco Studio目前以支持cmake的构建方式。本文将通过在IDE上适配cJSON三方库为例讲来解如何在IDE上集成cmake构建方式得三方库。
CMake中引入第三方库
HELLOWORLD2424的博客
01-04 937
能用find_package函数的前提是，OpenCVConfig.cmake写的很标准。但是如果一些常见的第三方库都写的不太标准导致不能用find_package。坏处是每次修改代码都要重新编译子项目。这里我们需要用add_subdirectory函数，然后把drogon引进来，编译然后用target_link_libraries函数进行连接。CMake中，如果我们需要引入第三方库，首先想到的是用find_package函数。的确，如果我们引入的第三方库是一些比较标准的库如OpenCV可以用下面的代码。
CMake 引用第三方库
qq_42170897的博客
08-07 4057
CMake 引用第三方库
cmake--添加第三方库
weixin_30606669的博客
04-14 3561
前言 大多数的工程都会添加第三方库。cmake中find_package()函数能够支持查找这些库的路径。 但是必须先为cmake配置查找配置的cmake模块，模块文件名称形如“FindXXX.cmake”，这些 模块文件通常会放到一个指定的目录中，然后将CMAKE_MODULE_PATH变量设置为该路径。 Linux系统默认的路径为“/usr/share/cmake/Modules”， ...
使用CMake导入第三方库
alan711的博客
01-10 3万+
使用CMakeLists.txt 中间需要导入第三方的库当我们需要生成自己的库的时候，下面介绍如何导入第三方库的具体步骤。 CMake的配置信息写在了CMakeList.txt文件中。在CMakeList.txt文件里，我们首先定义两个变量INC_DIR和LINK_DIR，用来表示头文件路径和库的路径。这里以我放在Downloads文件下的wfdb库为例，代码如下： set(INC_DIR /Us...
CMake调用第三方库的两种方法
08-29 2306
link_directories命令不需要cmake配置文件，只需要给出库的路径就可以了，使用相对简单，但不适合跨平台项目。而find_library会到类似XxxConfig.cmake 或 xxx-config.cmake 或 FindXxx.cmake文件去找动态库或静态库，如果自己写的库，或者第三方库没有对应的配置文件，需要自己编写对应的cmake config文件，相对于link_directories方法，就有些麻烦
CMake加入第三方库
wangrl的博客
01-26 7564
CMake构建工程的时候很多程序可以使用写好的库，这就会涉及到库的编译链接过程。这里使用的提到的 Ubuntu下libxml2的安装和使用xml库作为讲解示例，如何安转运行请点击链接。 使用kdevelop新建工程名字XmlDemo， CMakeLists.txt文件 cmake_minimum_required(VERSION 3.7) project(hello) add_e
大型跨平台Cmake项目，使用C++ QT代码实现，大部分功能以插件形式存在，使用vcpkg管理三方库，如何在install时自动拷贝依赖库，CMake版本在3.25以上，尽量使用CMake自带的命令
04-04
<think>好的，用户想在一个大型跨平台的CMake项目中使用C++和Qt，大部分功能以插件形式存在，并且用vcpkg管理第三方库。他们需要在安装时自动拷贝依赖库，CMake版本是3.25以上，尽量用CMake自带命令。我需要帮他们解决这个问题。 首先，用户的问题核心是安装时自动拷贝依赖库。我知道CMake中有几个相关命令，比如install()，但可能需要处理动态库的依赖。特别是跨平台的话，Windows、Linux、macOS处理方式不同。 在Windows下，DLL的拷贝比较麻烦。CMake自带的BundleUtilities和File(GET_RUNTIME_DEPENDENCIES)可能有用。不过BundleUtilities可能有点旧了，而File命令在3.15之后引入，用户用的是3.25，所以没问题。 对于Qt插件，可能需要处理额外的资源文件，比如平台插件、图像格式插件等。这些需要手动指定安装路径，并设置环境变量，比如QT_PLUGIN_PATH。 然后，vcpkg管理的三方库，安装后应该已经被正确找到，但动态库可能需要被自动收集。可能需要用vcpkg的特定脚本来帮助，比如vcpkg_copy_pdbs，不过不确定是否需要。 接下来，我需要组织步骤。首先，确保目标正确安装，包括可执行文件、插件和库文件。然后，收集运行时依赖，使用file(GET_RUNTIME_DEPENDENCIES)来获取动态库列表，并安装到相应目录。同时处理Qt插件，将它们拷贝到指定位置，并设置环境变量。 可能需要注意不同平台的处理，比如Windows用DLL，Linux用so，macOS用dylib。同时，检查CMake的生成表达式，确保在安装阶段执行依赖收集。 另外，Qt的部署工具比如windeployqt可能在Windows上有用，但用户希望用CMake自带命令，所以可能需要替代方案。或者结合使用，但可能需要额外步骤。 最后，测试安装后的目录结构，确保所有依赖都被正确拷贝，并且程序能运行。可能需要验证环境变量是否正确设置，比如插件路径。 总结步骤应该是：配置安装目标，收集运行时依赖，处理Qt插件，设置环境变量，最后测试验证。</think>以下是在CMake 3.25+环境下实现自动依赖库拷贝的解决方案，分步骤说明： $$----------------------------------$$ # 基础项目配置（CMakeLists.txt） $$----------------------------------$$ cmake_minimum_required(VERSION 3.25) project(MyProject) # 设置vcpkg工具链 set(CMAKE_TOOLCHAIN_FILE "$ENV{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake") # 启用自动包含依赖目录 set(CMAKE_INSTALL_DEFAULT_COMPONENT_NAME "Runtime") set(CMAKE_INSTALL_UCRT_LIBRARIES TRUE) # Windows特定 $$----------------------------------$$ # 主要功能实现步骤 $$----------------------------------$$ 1. **目标安装配置** ```cmake # 安装主程序 install(TARGETS ${PROJECT_NAME} RUNTIME DESTINATION bin BUNDLE DESTINATION bin LIBRARY DESTINATION lib ARCHIVE DESTINATION lib ) # 安装插件（每个插件单独处理） foreach(plugin ${PLUGIN_LIST}) install(TARGETS ${plugin} LIBRARY DESTINATION plugins/${plugin} RUNTIME DESTINATION plugins/${plugin} ) endforeach() ``` 2. **自动依赖收集** ```cmake # 获取所有运行时依赖 include(GNUInstallDirs) install(CODE [[ file(GET_RUNTIME_DEPENDENCIES EXECUTABLES $<TARGET_FILE:${PROJECT_NAME}> RESOLVED_DEPENDENCIES_VAR _r_deps UNRESOLVED_DEPENDENCIES_VAR _unresolved ) file(INSTALL DESTINATION "${CMAKE_INSTALL_PREFIX}/bin" TYPE SHARED_LIBRARY FILES ${_r_deps} ) ]]) ``` 3. **Qt特殊处理** ```cmake # 自动查找Qt依赖路径 find_package(Qt6 COMPONENTS Core Gui Widgets) get_target_property(QT_LIB_DIR Qt6::Core LOCATION) # 安装Qt核心运行时库 install(DIRECTORY "${QT_LIB_DIR}/" DESTINATION bin FILES_MATCHING PATTERN "*.dll" # Windows PATTERN "*.so*" # Linux PATTERN "*.dylib" # macOS ) ``` 4. **平台差异处理** ```cmake if(WIN32) # 处理VC运行时 include(InstallRequiredSystemLibraries) # 处理manifest文件 set(CMAKE_INSTALL_SYSTEM_RUNTIME_LIBS_SKIP TRUE) install(FILES $<TARGET_PDB_FILE:${PROJECT_NAME}> DESTINATION bin OPTIONAL ) endif() ``` 5. **环境变量配置** ```cmake # 生成设置环境变量的脚本 install(CODE [[ file(WRITE "${CMAKE_INSTALL_PREFIX}/setenv.bat" "@echo off\n" "set PATH=%PATH%;%~dp0/bin\n" "set QT_PLUGIN_PATH=%~dp0/plugins\n" ) file(WRITE "${CMAKE_INSTALL_PREFIX}/setenv.sh" "export PATH=\"$PATH:$PWD/bin\"\n" "export QT_PLUGIN_PATH=\"$PWD/plugins\"\n" ) ]]) ``` $$----------------------------------$$ # 关键点说明 $$----------------------------------$$ 1. **依赖收集机制** - 使用`file(GET_RUNTIME_DEPENDENCIES)`代替旧的`BundleUtilities` - 自动处理递归依赖关系 - 支持多平台（Windows/Mac/Linux） 2. **Qt特殊处理** - 需要单独处理Qt插件目录 - 确保`QT_PLUGIN_PATH`环境变量设置正确 - 注意平台差异： - Windows：`.dll` + `*.dll`资源文件 - Linux：`.so` + `qt.conf`配置 - macOS：`.dylib` + Framework处理 3. **vcpkg集成** - 确保`VCPKG_ROOT`环境变量已设置 - 使用`vcpkg integrate install`后的自动集成 - 通过`vcpkg_copy_pdbs()`可补充调试符号（需单独调用） 4. **验证方法** ```bash # 生成安装包 cmake --build build --target install # 检查安装目录结构 tree install/ # 应该包含： # ├── bin # ├── lib # └── plugins ``` 5. **高级优化建议** ```cmake # 使用CPack生成安装包 include(CPack) set(CPACK_INCLUDE_TOPLEVEL_DIRECTORY OFF) set(CPACK_PACKAGE_VERSION_MAJOR 1) cpack_add_component(Runtime REQUIRED) ``` 此方案特点： - 纯CMake实现，无外部工具依赖 - 支持动态库自动递归收集 - 正确处理Qt插件机制 - 生成环境配置脚本 - 兼容vcpkg管理机制 - 支持跨平台部署 实际部署时需注意： 1. 测试不同平台的路径分隔符差异 2. 处理ICU等Qt特殊依赖 3. 验证符号链接在Linux/macOS下的有效性 4. 考虑代码签名需求（macOS/Windows） 5. 处理调试/发布版本冲突
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值