用CMake下的find_package()函数链接库

find_package()原理

关于find_package()函数的相关内容可参考:

https://www.cnblogs.com/lidabo/p/16635249.html

Cmake 会在以下的路径中寻找Config.cmake或Find.cmake文件。找到后即可执行该文件并生成相关链接信息

<prefix>/(lib/<arch>|lib|share)/cmake/<name>*/          (U)
<prefix>/(lib/<arch>|lib|share)/<name>*/                (U)
<prefix>/(lib/<arch>|lib|share)/<name>*/(cmake|CMake)/  (U)

例如在我们的linux系统上用下面命令就能查看xxx.cmake文件

ls /usr/share/cmake-3.16/Modules

find_package的工作模式:

  • Module模式
    find_package命令基础工作模式(Basic Signature),也是默认工作模式。
  • Config模式
    find_package命令高级工作模式(Full Signature)。 只有在find_package()中指定CONFIG、NO_MODULE等关键字,或者Module模式查找失败后才会进入到Config模式。

案例1:为项目添加库

需求:现有一个libadd库,我们希望别的项目可以通过find_package对它进行引用我们应该怎么办呢?

首先我们创建一个文件夹 libadd
在该文件夹下有两个文件:
libadd.cpp

#include <iostream>
#include "libadd.h"

using namespace std;

void libadd(int a,int b){
    nt res = a+b;
    cout<<a<<"+"<<b<<"="<<res<<endl;
}

libadd.h

#ifndef _HEAD_H
#define _HEAD_H
// 加法
void libadd(int a, int b);
#endif

接下来需要得到一个库文件,输入下面的命令:

# 编译生成共享库,也可以在makefile中编译
g++ -c -fPIC libadd.cpp -o libadd.so

同时在该文件夹下新建 Makefile 文件,输入:

CC = g++
CFLAGS  := -Wall -O3 -std=c++11 

LIB = libadd.so # 目标文件名
INCLUDE = ./ # 头文件目录
HEADER = libadd.h # 头文件

all : install

# 2. 生成.o文件 

# 3. 生成动态库文件


# 4. 删除中间过程生成的文件 

# 5.安装文件
install:
    cp $(LIB) /home/nio/workspace/Gitspace/cmaketest/install
    cp $(HEADER) /home/nio/workspace/Gitspace/cmaketest/install

现在该文件夹(/home/nio/workspace/Gitspace/cmaketest/libadd)下有下面四个文件:

接下来把头文件和库安装到一个自定义文件夹中,这边装在install里面

mkdir ../install

make install

不出意外的话,install里面会有头文件和库

第一步工作完成了,也就是说libadd的库已经做好了,接下来在任意地方新建一个test文件夹,创建一个main.cpp用于调用libadd
main.cpp

#include<iostream>
#include "libadd.h"

int main(){
    libadd(1,2);
}

再新建一个CMakeLists.txt 文件,我们要在生存可执行文件的同时链接到Add的库

CMakeLists.txt

cmake_minimum_required(VERSION 3.0)
# 工程名
project(Test)


set(CMAKE_MODULE_PATH "${CMAKE_SOURCE_DIR}"i)
add_executable(main main.cpp)
find_package(Add)
if(ADD_FOUND)
    target_include_directories(main PRIVATE ${ADD_INCLUDE_DIR})
    target_link_libraries(main ${ADD_LIBRARY})
else(ADD_FOUND)
    message(FATAL_ERROR "ADD library not found")
endif(ADD_FOUND)

再新建一个FindAdd.cmake文件,用于找到Add的库,需要把头文件和库的地址都给出

FindAdd.cmake

find_path(ADD_INCLUDE_DIR libadd.h /home/nio/workspace/Gitspace/cmaketest/install)
find_library(ADD_LIBRARY libadd.so /home/nio/workspace/Gitspace/cmaketest/install)

if (ADD_INCLUDE_DIR AND ADD_LIBRARY)
    set(ADD_FOUND TRUE)
endif (ADD_INCLUDE_DIR AND ADD_LIBRAR)

最后在当前文件夹中执行:

mkdir build
cd build

cmake ..
make
./main

最后输出结果

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
要编写一个可以被其他CMake文件find_package的包,需要执行以下步骤: 1. 创建一个包含代码的库或二进制文件,并将其安装到系统上。 2. 创建一个CMake配置文件,该文件定义了包的版本号、库/二进制文件路径等信息,并将其安装到系统上。 3. 创建一个CMake模块文件,该文件包含一个find_package函数,用于查找并加载CMake配置文件。 下面是更详细的步骤: 1. 创建库或二进制文件 在CMakeLists.txt中定义库或二进制文件,例如: ``` add_library(mylib SHARED mylib.cpp) # 创建一个共享库 install(TARGETS mylib LIBRARY DESTINATION lib) # 安装该库到系统上 ``` 2. 创建CMake配置文件 创建一个名为`mylib-config.cmake.in`的文件,该文件包含了包的版本号、库文件路径等信息。注意,该文件中需要使用`@VAR@`的形式来引用变量,CMake将在安装时将这些变量替换为实际值。例如: ``` @PACKAGE_INIT@ set(MYLIB_VERSION_MAJOR 1) set(MYLIB_VERSION_MINOR 0) set(MYLIB_VERSION_PATCH 0) set(MYLIB_VERSION "${MYLIB_VERSION_MAJOR}.${MYLIB_VERSION_MINOR}.${MYLIB_VERSION_PATCH}") set(MYLIB_INCLUDE_DIRS "${CMAKE_INSTALL_PREFIX}/include") set(MYLIB_LIBRARIES "${CMAKE_INSTALL_PREFIX}/lib/libmylib.so") configure_file(${CMAKE_CURRENT_SOURCE_DIR}/mylib-config.cmake.in ${CMAKE_CURRENT_BINARY_DIR}/mylib-config.cmake @ONLY) install(FILES ${CMAKE_CURRENT_BINARY_DIR}/mylib-config.cmake DESTINATION lib/cmake/mylib) ``` 该文件中使用了`@PACKAGE_INIT@`宏来加载CMake的基本配置信息。 3. 创建CMake模块文件 创建一个名为`FindMylib.cmake`的文件,该文件包含了一个find_package函数,用于查找并加载CMake配置文件。例如: ``` find_package(PkgConfig) pkg_check_modules(PC_MYLIB QUIET mylib) find_path(MYLIB_INCLUDE_DIR mylib.h HINTS ${PC_MYLIB_INCLUDE_DIRS} ${CMAKE_INSTALL_PREFIX}/include) find_library(MYLIB_LIBRARY NAMES mylib HINTS ${PC_MYLIB_LIBDIR} ${CMAKE_INSTALL_PREFIX}/lib) include(FindPackageHandleStandardArgs) find_package_handle_standard_args(Mylib REQUIRED_VARS MYLIB_INCLUDE_DIR MYLIB_LIBRARY VERSION_VAR MYLIB_VERSION) if(Mylib_FOUND) set(MYLIB_LIBRARIES ${MYLIB_LIBRARY}) set(MYLIB_INCLUDE_DIRS ${MYLIB_INCLUDE_DIR}) endif() mark_as_advanced(MYLIB_INCLUDE_DIR MYLIB_LIBRARY) ``` 该文件中使用了`find_package_handle_standard_args`函数来检查包是否已找到,并将结果保存在`Mylib_FOUND`变量中。此外,还定义了`MYLIB_INCLUDE_DIRS`和`MYLIB_LIBRARIES`变量,用于在其他CMake文件中引用。 4. 安装包 在CMakeLists.txt中添加以下内容,用于安装CMake配置文件和模块文件: ``` install(FILES ${CMAKE_CURRENT_BINARY_DIR}/mylib-config.cmake DESTINATION lib/cmake/mylib) install(FILES FindMylib.cmake DESTINATION lib/cmake/mylib) ``` 5. 使用包 在其他CMake文件中,可以使用`find_package`函数来查找并加载该包,例如: ``` find_package(Mylib REQUIRED) include_directories(${MYLIB_INCLUDE_DIRS}) target_link_libraries(myapp ${MYLIB_LIBRARIES}) ``` 注意,上述代码中的`Mylib`是指在FindMylib.cmake中定义的包名,而不是库/二进制文件的名称。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

木白CPP

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值