高端响应式网站建设中国菲律宾商会会长
CMake 的 FetchContent 模块是一个非常方便的工具，用于在构建过程中从远程位置下载和管理外部依赖项。通过 FetchContent，您可以在项目的 CMake 配置过程中下载、提取和添加外部项目，而不需要手动管理这些依赖项。下面是 FetchContent 的基本用法介绍以及一个简单的代码示例，代码结构如下：
FetchContent 基本用法
-
引入 FetchContent 模块
在 CMakeLists.txt 文件中，首先需要引入 FetchContent 模块：include(FetchContent) -
声明并下载外部项目
使用FetchContent_Declare函数声明外部项目，并使用FetchContent_MakeAvailable函数下载并解压该项目。例如，下载并构建一个外部项目googletest：FetchContent_Declare(googletestGIT_REPOSITORY https://github.com/google/googletest.gitGIT_TAG release-1.11.0 )FetchContent_MakeAvailable(googletest) -
使用外部项目
一旦外部项目被下载和解压，就可以像项目中的其他库一样使用它。例如，链接googletest库到你的项目中：target_link_libraries(my_project PRIVATE gtest_main)
完整示例
下面是一个完整的示例，演示如何使用 FetchContent 下载并构建 googletest 并将其链接到一个简单的 C++ 项目。
项目结构：
/my_project
|-- CMakeLists.txt
|-- src
| |-- main.cpp
|-- tests|-- test_main.cpp
CMakeLists.txt：
cmake_minimum_required(VERSION 3.14)
project(MyProject)# 设置C++标准
set(CMAKE_CXX_STANDARD 14)# 引入FetchContent模块
include(FetchContent)# 声明googletest
FetchContent_Declare(googletestGIT_REPOSITORY https://github.com/google/googletest.gitGIT_TAG release-1.11.0
)# 下载并解压googletest
FetchContent_MakeAvailable(googletest)# 添加源文件
add_executable(my_project src/main.cpp)# 链接googletest库到测试项目
enable_testing()
add_executable(test_main tests/test_main.cpp)
target_link_libraries(test_main PRIVATE gtest_main)# 添加测试
add_test(NAME MyTest COMMAND test_main)
src/main.cpp：
#include <iostream>int main() {std::cout << "Hello, World!" << std::endl;return 0;
}
tests/test_main.cpp：
#include <gtest/gtest.h>TEST(SampleTest, AssertionTrue) {EXPECT_TRUE(true);
}int main(int argc, char **argv) {::testing::InitGoogleTest(&argc, argv);return RUN_ALL_TESTS();
}
解释
- CMakeLists.txt 中包含了项目配置、
FetchContent配置以及项目和测试可执行文件的构建和链接。 FetchContent_Declare和FetchContent_MakeAvailable用于声明和下载googletest。- 使用
target_link_libraries将googletest链接到测试可执行文件test_main。 - 在
tests/test_main.cpp中编写了一个简单的测试案例，并使用gtest_main运行所有测试。
通过这种方式，您可以轻松地在项目中引入和管理外部依赖项，而无需手动下载和配置这些库。
注意由于需要从github下载库，得有合适的网络环境，不然会无法下载或编译失败，例如下图：
如果是正常编译下载库，在编译后的目录build/_deps是FetchContent下载的库
FetchContent如何添加多个库
使用 CMake 的 FetchContent_Declare 和 FetchContent_MakeAvailable 可以下载和管理多个库。您只需为每个库单独调用 FetchContent_Declare 和 FetchContent_MakeAvailable。
示例代码
假设您想要下载并使用 googletest 和 fmt 库，这里是如何编写 CMakeLists.txt 文件的示例。
项目结构：
/my_project
|-- CMakeLists.txt
|-- src
| |-- main.cpp
|-- tests|-- test_main.cpp
CMakeLists.txt：
cmake_minimum_required(VERSION 3.14)
project(MyProject)# 设置C++标准
set(CMAKE_CXX_STANDARD 14)# 引入FetchContent模块
include(FetchContent)# 声明googletest
FetchContent_Declare(googletestGIT_REPOSITORY https://github.com/google/googletest.gitGIT_TAG release-1.11.0
)# 声明fmt
FetchContent_Declare(fmtGIT_REPOSITORY https://github.com/fmtlib/fmt.gitGIT_TAG 8.0.1
)# 下载并解压所有声明的内容
FetchContent_MakeAvailable(googletest fmt)# 添加源文件
add_executable(my_project src/main.cpp)# 链接fmt库到主项目
target_link_libraries(my_project PRIVATE fmt::fmt)# 链接googletest库到测试项目
enable_testing()
add_executable(test_main tests/test_main.cpp)
target_link_libraries(test_main PRIVATE gtest_main)# 添加测试
add_test(NAME MyTest COMMAND test_main)
src/main.cpp：
#include <iostream>
#include <fmt/core.h>int main() {fmt::print("Hello, World!\n");return 0;
}
tests/test_main.cpp：
#include <gtest/gtest.h>TEST(SampleTest, AssertionTrue) {EXPECT_TRUE(true);
}int main(int argc, char **argv) {::testing::InitGoogleTest(&argc, argv);return RUN_ALL_TESTS();
}
解释
-
引入 FetchContent 模块：
include(FetchContent) -
声明多个库：
使用FetchContent_Declare为每个库声明其存储库位置和版本。FetchContent_Declare(googletestGIT_REPOSITORY https://github.com/google/googletest.gitGIT_TAG release-1.11.0 )FetchContent_Declare(fmtGIT_REPOSITORY https://github.com/fmtlib/fmt.gitGIT_TAG 8.0.1 ) -
下载并解压所有声明的内容：
使用FetchContent_MakeAvailable下载并解压所有已声明的库。FetchContent_MakeAvailable(googletest fmt) -
使用下载的库：
将下载的库链接到您的项目中。target_link_libraries(my_project PRIVATE fmt::fmt) target_link_libraries(test_main PRIVATE gtest_main)
通过这种方式，您可以轻松地管理和使用多个外部库。每个库的声明和下载是独立的，FetchContent 模块会自动处理依赖关系和构建顺序。