pkg-config手册

发布时间 2023-08-15 10:43:23作者: 七彩代码

定义

pkg-config是一款用于返回已安装库元信息的工具;

(语法)概要

pkg-config [--modversion] [--help] [--print-errors] [--silence-errors] [--cflags] [--libs] [--libs-only-L] [--libs-only-l] [--cflags-only-I] [--variable=VARIABLENAME] [--define-variable=VARIABLENAME=VARIABLEVALUE] [--uninstalled] [--exists] [--atleast-version=VERSION] [--exact-version=VERSION] [--max-version=VERSION] [LIBRARIES...]

说明

pkg-config用于检索系统中已安装库的信息;其典型应用场景是编译或链接一个或多个库(依赖检查),例如以下是Makefile中的使用场景:

program: program.c
cc program.c 'pkg-config --cflags --libs gnomeui'

pkg-config从特定配置文件中检索安装包信息,此类文件默认以.pc结尾,pkg-config在prefix/lib/pkgconfig目录下搜索,同时也会在PKG_CONFIG_PATH 环境变量指定的冒号分隔的路径列表中检索(Windows下是分号);
在pkg-config命令行指定的包名,对应去掉 .pc 扩展名后的元数据的配置文件名。如果一个库同时安装了多个版本,库名必须加版本号以便区分(例如GTK 1.2的包名可能是"gtk+"而 GTK 2.0是 "gtk+-2.0")。

命令行选项

--modversion

检索命令行指定库名版本信息,如果pkg-config能找到命令行中所有库,则将其版本号打印到标准输出,每个版本号一行,此时pkg-config成功退出。如果一个或多个库未找到,pkg-config返回非零错误码,标准输出内容为未定义。

--help

显示帮助信息并退出

--cflags

打印命令行指定的包编译时所需预处理和编译标识符,包括其他依赖所需标识符;标识符是被压缩的,以保证每个标识符只出现一次;如果命令行指定的一个或多个包元数据找不到,pkg-config返回非零错误码。

--libs

等同"--cflags",但是只打印链接标识符。和"--cflags"一样,重复的标识符被合并,第三方依赖所需标识符被打印到输出。

--libs-only-L

输出"--libs"的-L/-R部分.意思是其中定了依赖库的搜索路径,但不指定链接哪个库。

--libs-only-l

打印命令行指定库的"--libs"的-l部分。但是!"--libs-only-l" 和 "--libs-only-L"加起来可能比"--libs"涵盖内容少,因为例如-rdynamic上的差异.
Environment Variables

PKG_CONFIG_PATH

冒号分隔的.pc 文件检索路径列表。该路径检索完后默认路径也会被检索,默认路径是libdir/pkgconfig:datadir/pkgconfig。libdir是 pkg-config安装目录下的lib和data目录.