从零开始 CMake 学习笔记 (H)third-party-library
开始前先默念三遍口诀:
- Declare a target
- Declare target’s traits
- It’s all about targets
本系列主要根据GitHub上的 cmake-examples 项目进行翻译总结,同时对于不清晰的概念及函数进行查阅理解记录形成。
文章目录
1 介绍
本示例展示了如何查找及支持第三方库。几乎所有大的项目都需要用到第三方库、头文件或程序。CMake支持使用 find_package()
函数来查找这个工具的路径。但是必须先为cmake配置查找配置的cmake模块,模块文件名称形如“FindXXX.cmake”,这些模块文件通常会放到一个指定的目录中,然后将CMAKE_MODULE_PATH
变量设置为该路径。Linux系统默认的路径为“/usr/share/cmake/Modules”。
本示例需要提前安装boost。
1.1 文件树
H-third-party-library $ tree
.
├── CMakeLists.txt
├── main.cpp
1.2 文件简介
- CMakeLists.txt - 包含了你希望运行的 CMake 命令
cmake_minimum_required(VERSION 3.5)
// 项目名
project (third_party_include)
// 找到 boost 的特定版本,COMPONENTS后面罗列的是 boost 的一些子模块
find_package(Boost 1.46.1 REQUIRED COMPONENTS filesystem system)
// 检查是否找到
if(Boost_FOUND)
message ("boost found")
else()
message (FATAL_ERROR "Cannot find Boost")
endif()
// 添加可执行文件
add_executable(third_party_include main.cpp)
// 将第三方库链接到可执行文件
target_link_libraries( third_party_include
PRIVATE
Boost::filesystem
)
-main.cpp - main文件
#include <iostream>
#include <boost/shared_ptr.hpp>
#include <boost/filesystem.hpp>
int main(int argc, char *argv[])
{
std::cout << "Hello Third Party Include!" << std::endl;
// new一个智能指针
boost::shared_ptr<int> isp(new int(4));
// boost文件系统的简单调用
boost::filesystem::path path = "/usr/share/cmake/modules";