cmake以源码的方式引入第三方项目

最前#

本文将介绍一种以源码的方式引入第三方库的方法

准备#

主项目，需要引用第三方库的某些函数
第三方库，以源码的形式提供给主项目使用
注意：本文的背景：已经将第三方源码下载好。

一个例子#

我这里准备一个简单的项目，调用第三方库 fmt；其中fmt是以源码的形式引入项目

cmake version: 3.17
platform: os X 10.15

目录结构#

Copy Highlighter-hljs

.
├── build            # 存放cmake配置结果
├── cmake         # 自己写的 .cmake 文件存放目录
├── ext            # 第三方源码存放目录
│   ├── fmt      # fmt库
│   └── spdlog-1.x  # spdlog库
└── src      # 主项目的 .cc文件目录

fmt.cmake 文件内容#

spdlog与fmt库都是第三方库，本文只演示fmt库。 fmt.cmake存放在cmake目录下

Copy Highlighter-hljs

include(FetchContent)

FetchContent_Declare(
    fmt 
    SOURCE_DIR ${PROJECT_SOURCE_DIR}/ext/fmt
)

FetchContent_GetProperties(fmt)
if (NOT fmt_POPULATED)
    FetchContent_Populate(fmt)
    # win:下面这行是将fmt添加到解决方案中
    add_subdirectory(${fmt_SOURCE_DIR} ${fmt_BINARY_DIR})
endif()

其中， FetchContent_Declare用法如下：

Copy Highlighter-hljs

FetchContent_Declare(
    fmt             # 库的名字
    SOURCE_DIR ${PROJECT_SOURCE_DIR}/ext/fmt            # 库在本地的哪个目录
)

回报根目录下的 CMakeLists.txt#

使用 include 包含库 fmt 。

Copy Highlighter-hljs

# 设置搜索路径
set(CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake;${CMAKE_MODULE_PATH}")
# 包含目录
include(fmt)

完整源码

Copy Highlighter-hljs

cmake_minimum_required(VERSION 3.17)

# ---------------------------------------------------------------------------------------------------
# 1. set name
project(demo_fp)

aux_source_directory( "${CMAKE_CURRENT_SOURCE_DIR}/src" src_cc)

set(CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake;${CMAKE_MODULE_PATH}")
include(fmt)

if(fmt_FOUND)
    message(STATUS "1111 its not find fmt library- ------------")
else()
	message(STATUS "2222 its find fmt library- ------------")
	add_executable(${PROJECT_NAME})
	target_sources(${PROJECT_NAME} PUBLIC ${src_cc})
	target_link_libraries(${PROJECT_NAME} PUBLIC fmt::fmt)
	
endif(fmt_FOUND)

cmake配置结果#

转到 build 目录，执行cmake .. ，结果：

再执行命令： make 即可得到结果

well done.

src/main.cc内容#

根目录 src下的main.cc文件内容

Copy Highlighter-hljs

#ifdef _WIN32
#pragma once
#endif 

#include <fmt/format.h>
#include <iostream>
int main(int argc, char* argv[], char* env[])
{
    std::string str = fmt::format("{0} + {1} = {2}", 1, 2, 3);
    std::cout << "str=" << str.c_str() << "\n\n";

    return 0;
}