Linux操作系统中pkg-config用法示例

亦凉 2021-12-21 11:13 440阅读 0赞

本文介绍 Linux 操作系统中 pkg-config工具的用法示例。

# 1 概述 #

pkgconfig 软件包的描述信息如下：

> A tool for determining compilation options.

Manual 手册中对于 pkg-config 的介绍信息如下：

> pkg-config - Return metainformation about installed libraries.
> 
> The pkg-config program is used to **retrieve information about installed libraries in the system**.  It is typically used to **compile and link** against one or more libraries.
> 
> pkg-config  retrieves  information  about  packages  from  special metadata files. These files are named after the package, and has a **.pc extension**. It will additionally look in the colon-separated list of directories specified by the **PKG\_CONFIG\_PATH** environment variable.

pkg-config 官网中的介绍信息如下：

> pkg-config is a helper tool used when **compiling** applications and libraries. It helps you **insert the correct compiler options** on the command line so an application can use *gcc -o test test.c \`pkg-config --libs --cflags glib-2.0\`* for instance, rather than hard-coding values on where to find glib (or other libraries). It is language-agnostic, so it can be used for defining the location of documentation tools, for instance.

总结上述介绍信息，可知：pkg-config 用于返回系统上已安装的库的相关信息，这些信息在**编译和连接**与该库相关的程序或库的过程中使用。

需要强调的是，pkg-config 用于程序或库的**编译和连接**过程，而非**运行**过程。

# 2 示例 #

下面通过一个示例，介绍 pkg-config 的使用场景及用法。

假设在系统上安装了 x265 库，安装位置为 /usr/local，因此，其对应的库文件为 /usr/local/lib/libx265.so，头文件为 /usr/local/include/x265.h，这些在**编译和连接**其他程序或库（如 ffmpeg）时所需的相关信息，都包含在 /usr/local/lib/pkgconfig/x265.pc 文件中。x265.pc 文件的内容如下：

[root@livestreamserver /usr/local]# cat /usr/local/lib/pkgconfig/x265.pc 
    prefix=/usr/local
    exec_prefix=${prefix}
    libdir=${exec_prefix}/lib
    includedir=${prefix}/include
    
    Name: x265
    Description: H.265/HEVC video encoder
    Version: 3.5
    Libs: -L${libdir} -lx265
    Libs.private: -lstdc++ -lm -lgcc_s -lgcc -lgcc_s -lgcc -lrt -ldl
    Cflags: -I${includedir}
    [root@livestreamserver /usr/local]#

现在以构建启用 x265 编码功能的 ffmpeg 为例，介绍 pkg-config 的具体用法。

在构建 ffmpeg 时，首先需要通过 ./configure --enable-gpl --enable-libx265 命令创建构建选项。由于指定了要使用 x265 库，所以该命令运行过程中会通过 pkg-config 寻找 x265 库的相关信息。

在不进行任何 pkg-config 配置的情况下，上面的 configure 命令会报错，提示在使用 pkg-config 找不到 x265 的相关信息，错误信息如下图所示：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpaXRkYXI_size_16_color_FFFFFF_t_70][]

出现上面错误，是由于 pkg-config 没有找到 x265.pc 文件，获取不到编译所需的 x265 库的相关信息。

pkg-config 会通过以下**两种途径**寻找库的 .pc 文件：

*  在系统默认的 .pc 文件目录（如 /usr/lib64/pkgconfig/）下寻找；
 *  通过环境变量 PKG\_CONFIG\_PATH 中的路径寻找。

在本文中，采用向环境变量 PKG\_CONFIG\_PATH 中添加 x265.pc 所在目录（即 /usr/local/lib/pkgconfig/）的方式解决 configure 命令的报错问题。修改环境变量 PKG\_CONFIG\_PATH 的相关命令如下：

export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH

说明：可以将上面的命令添加到系统配置文件（如 /etc/profile）或者用户配置文件中（如 ~/.bash\_profile）中，以避免 PKG\_CONFIG\_PATH 的值在切换终端或系统重启后失效。

完成上述操作后，再次运行 ./configure --enable-gpl --enable-libx265 命令，就可以找到 x265 库的相关信息，也就不会再出现错误信息了。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpaXRkYXI_size_16_color_FFFFFF_t_70]: /images/20211221/9cc82110a2f74223a5ec673820d36e9e.png