CMake:检测外部库---使用pkg-config

导言

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

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

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

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

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

接下来，我们通过对ZMQ的简单使用，来演示第一种方法的使用。

ZMQ安装

ZMQ下载：

https://github.com/zeromq

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

tar -xzvf  libzmq-4.3.4.tar.gz .

cd libzmq-4.3.4

开始安装

./autogen.sh

使用prefix来指定安装目录

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

项目结构

.
├── CMakeLists.txt
├── zmq_client.cpp
└── zmq_server.cpp

项目地址：

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

CMakeLists.txt

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库。

pkg_search_module(
  ZeroMQ
  REQUIRED libzeromq libzmq lib0mq
  IMPORTED_TARGET
)

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

相关源码

zmq_client.cpp

#include 
#include 
#include 
#include 

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

include <stdio.h>
#include 
#include 
#include 

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;
}

构建项目，并执行

$ mkdir -p build
$ cd build
$ cmake ..
$ cmake --build .

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

祝大家变得更强！！！