CMake引入三方库

做移动端的NDK开发经常需要引入三方库，本文以常见的JSON库为例进行说明

jsoncpp源码下载地址https://github.com/open-source-parsers/jsoncpp

下载1.9.5的tag

1、纯源码依赖

testjson1.zip

工程目录如下：

jsoncpp目录下是json的源码

main.cpp是测试代码，如下

#include 
 
#include "json/json.h"
 
int main() {
 
Json::Value json;
 
json["name"] = "Wiki";
 
json["age"] = 18;
 
std::cout << json.toStyledString() << std::endl;
 
return 0;
 
}

CMakeLists.txt

cmake_minimum_required(VERSION 3.17)
 
project(testjson)
 
set(CMAKE_CXX_STANDARD 14)
 
# 头文件引入
 
include_directories(./jsoncpp/include)
 
#查找当前目录下、及protocol目录下所有cpp文件，保存在变量SEC_LIST中
 
file(GLOB SRC_LIST "*.cpp" "jsoncpp/*.cpp")
 
add_executable(testjson ${SRC_LIST})
 
# add_library(testjson SHARED ${SRC_LIST})

执行结果

2、内部工程依赖

testjson2.zip

有的时候，三方库是公司内部其他团队提供的，除了提供源码，还自带了CMakeLists.txt

还以jsoncpp为例，目录结构如下：

jsoncpp目录内的CMakeLists.txt如下：

cmake_minimum_required(VERSION 3.17)
 
# 指定C++版本 1.9.5版本的jsoncpp需要用C++11版本的
 
set(CMAKE_CXX_STANDARD 11)
 
project(jsoncpp)
 
add_library(${PROJECT_NAME} json_tool.h json_valueiterator.inl json_reader.cpp json_value.cpp json_writer.cpp)
 
target_include_directories(${PROJECT_NAME} PUBLIC ${PROJECT_SOURCE_DIR}/include)

主工程目录内的CMakeLists.txt如下：

cmake_minimum_required(VERSION 3.17)
 
# 指定C++版本 1.9.5版本的jsoncpp需要用C++11版本的
 
set(CMAKE_CXX_STANDARD 11)
 
project(testjson)
 
# 添加子工程
 
add_subdirectory(jsoncpp)
 
add_executable(${PROJECT_NAME} main.cpp)
 
# 链接子工程，子工程addlibrary时生成的名字
 
target_link_libraries(${PROJECT_NAME} jsoncpp)

执行结果

3、静态库/动态库方式依赖

testjson3.zip

有时，三方没有提供源码，只提供了头文件和静态库文件

还以jsoncpp为例，使用2中编译出来的jsoncpp静态文件

工程目录如下：

主工程目录内的CMakeLists.txt如下：

cmake_minimum_required(VERSION 3.17)
 
# 指定C++版本
 
set(CMAKE_CXX_STANDARD 11)
 
project(testjson)
 
# 包含头文件
 
include_directories(jsoncpp/include)
 
add_executable(${PROJECT_NAME} main.cpp)
 
# 找到三方静态库
 
find_library(jsoncpp_lib NAMES jsoncpp PATHS ./jsoncpp)
 
target_link_libraries(${PROJECT_NAME} ${jsoncpp_lib})

执行结果

参考文章

1、C++工程：总结 CMake 添加第三方库依赖方式git submodule、 find_library、FetchContent、CPM等 https://www.jianshu.com/p/f181b5bd0a63

2、target_include_directories和include_directories 区别cmake：target_** 中的 PUBLIC，PRIVATE，INTERFACE - 知乎

3、动态链接和静态链接的区别 https://www.jianshu.com/p/c3ff6310f1f4