CMake 笔记 | [16] 检测外部库---使用pkg-config

注意
本文最后更新于 2024-01-29,文中内容可能已过时。

一、检测外部库—使用pkg-config

导言

前面几篇内容的学习,我们基本上了解了如何链接一个三方库的方法。本篇以及下一篇将补充两个检测外部库的方法。

目前为止,我们已经学习了两种检测外部依赖关系的方法:

  • 使用CMake自带的find-module,但并不是所有的包在CMakefind模块都找得到。
  • 使用<package>Config.cmake ,<package>ConfigVersion.cmake<package>Targets.cmake,这些文件由软件包供应商提供,并与软件包一起安装在标准位置的cmake文件夹下。

如果某个依赖项既不提供查找模块,也不提供供应商的CMake文件,在这种情况下:

  • 依赖pkg-config程序,来找到系统上的包。这依赖于包供应商在.pc配置文件中,其中有关于发行包的元数据。
  • 为依赖项编写自己的find-package模块。

接下来,我们通过ZMQ的使用,来演示第一种方法的使用。

二、ZMQ的安装

ZMQ下载:

https://github.com/zeromq

下载好后解压, 并进入目录::

1
2
3
tar -xzvf  libzmq-4.3.4.tar.gz .

cd libzmq-4.3.4

开始安装

1
./autogen.sh

使用prefix来指定安装目录

1
2
3
./configure --prefix=/opt/zmq/ --without-libsodium
make
sudo make install

三、项目结构

1
2
3
4
.
├── CMakeLists.txt
├── zmq_client.cpp
└── zmq_server.cpp

项目地址:

https://gitee.com/jiangli01/tutorials/tree/master/cmake-tutorial/chapter3/05

CMakeLists.txt
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
cmake_minimum_required(VERSION 3.10 FATAL_ERROR)

project(test_zmq LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_EXTENSIONS OFF)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_PREFIX_PATH /opt/zmq)

find_package(PkgConfig REQUIRED QUIET)

pkg_search_module(
  ZeroMQ
  REQUIRED libzeromq libzmq lib0mq
  IMPORTED_TARGET
)

if(TARGET PkgConfig::ZeroMQ)
    message(STATUS "Found ZeroMQ")
endif()

add_executable(hw_server zmq_server.cpp)
target_link_libraries(hw_server PkgConfig::ZeroMQ)

add_executable(hw_client zmq_client.cpp)
target_link_libraries(hw_client PkgConfig::ZeroMQ)

使用pkg_search_module通搜索任何附带包配置.pc文件的库或程序来查找和导入ZeroMQ库。这个命令会在CMake中通过PkgConfig工具查找和配置ZeroMQ库。

1
2
3
4
5
pkg_search_module(
  ZeroMQ
  REQUIRED libzeromq libzmq lib0mq
  IMPORTED_TARGET
)

ZeroMQ的信息将会被存储在一个导入目标中,其名称是PkgConfig::ZeroMQ,可以将这个目标链接到可执行文件或库。



导入目标

相关源码

zmq_client.cpp

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
#include <stdio.h>
#include <string.h>
#include <unistd.h>
#include <zmq.h>

int main() {
  void *context = zmq_ctx_new();
  void *requester = zmq_socket(context, ZMQ_REQ);
  int rc = zmq_connect(requester, "tcp://localhost:5555");

  if (rc != 0) {
    perror("Failed to connect to server");
    return 1;
  }

  while (true) {
    char buffer[] = "Hello";
    zmq_send(requester, buffer, sizeof(buffer), 0);

    char reply[10];
    zmq_recv(requester, reply, sizeof(reply), 0);
    printf("Received: %s\n", reply);

    sleep(10);
  }

  zmq_close(requester);
  zmq_ctx_destroy(context);

  return 0;
}

zmq_server.cpp

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
include <stdio.h>
#include <string.h>
#include <unistd.h>
#include <zmq.h>

int main() {
  void *context = zmq_ctx_new();
  void *responder = zmq_socket(context, ZMQ_REP);
  int rc = zmq_bind(responder, "tcp://*:5555");

  if (rc != 0) {
    perror("Failed to bind socket");
    return 1;
  }

  while (1) {
    char buffer[10];
    zmq_recv(responder, buffer, sizeof(buffer), 0);
    printf("Received: %s\n", buffer);

    zmq_send(responder, "World", 5, 0);
  }

  zmq_close(responder);
  zmq_ctx_destroy(context);

  return 0;
}

构建项目,并执行

1
2
3
4
$ mkdir -p build
$ cd build
$ cmake ..
$ cmake --build .

执行生成的两个进程结果:



输出结果

Buy me a coffee~
支付宝
微信
0%