pkg-config使用简述
pkg-config工具安装使用PkgConfig（pkg-config）是一个在 Linux/Unix 开发中管理库的编译和链接参数的工具，能自动生成正确的头文件路径（-I）、库路径（-L）和链接库名称（-l）等标志。以下为详细使用指南：
pkg-config命令使用
1. 安装
[*]Debian/Ubuntu：
sudo apt-get install pkg-config
[*]CentOS/RHEL：
sudo yum install pkg-config
2. 基本命令
[*]检查库是否存在：
pkg-config --exists <库名># 返回 0 表示存在
[*]命令实际使用时的表现是：
[*]成功：返回状态码 0，无输出。
[*]失败：返回状态码 非0，默认无输出（需 --print-errors显示错误）。
[*]获取库版本：
pkg-config --modversion <库名># 输出版本号（如 2.66.0）
[*]提取编译选项（头文件路径） ：
pkg-config --cflags <库名># 输出 -I/usr/include/glib-2.0
[*]默认过滤系统路径/usr/include
[*]提取链接选项（库路径及名称） ：
pkg-config --libs <库名># 输出 -L/usr/lib -lglib-2.0
[*]同时获取编译和链接选项：
pkg-config --cflags --libs <库名>
3. 配置搜索路径（PKG_CONFIG_PATH）
若库安装在非标准路径（如 /usr/local/lib），需设置环境变量：
export PKG_CONFIG_PATH=/custom/path/lib/pkgconfig:$PKG_CONFIG_PATH
[*]示例：
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH
[*]永久生效：将命令添加到 ~/.bashrc或 /etc/profile。
4. 在编译命令中使用
在 gcc/g++中直接嵌入 pkg-config命令：
gcc program.c $(pkg-config --cflags --libs <库名>glib-2.0) -o program或使用反引号：
gcc program.c `pkg-config --cflags --libs <库名>glib-2.0` -o program优势：自动处理依赖（如 glib-2.0依赖的其他库），避免手动指定路径。
5. 高级用法
[*]静态链接：
pkg-config --static --libs <库名># 输出静态库链接标志
[*]检查最小版本：
pkg-config --atleast-version=2.0.0 glib-2.0# 版本≥2.0.0 返回 0
[*]列出所有可用库：
pkg-config --list-all
6. 为自定义库创建 .pc 文件
若开发新库，需在 /usr/local/lib/pkgconfig/下创建 .pc文件：
prefix=/usr/local
exec_prefix=${prefix}
libdir=${exec_prefix}/lib
includedir=${prefix}/include
<p>Name: mylib
Description: Custom Library
Version: 1.0.0
Libs: -L\({libdir} -lmylib
Cflags: -I\){includedir}/mylib
</p>
关键字段：
[*]Name：库标识名（pkg-config查询用）。
[*]Libs/Cflags：链接和编译标志。
[*]Requires：声明依赖库（如 Requires: glib-2.0）
。
7. 常见问题
[*]错误提示 "Package not found" ：
[*]确认库的开发包已安装（如 libpng-dev）。
[*]检查 .pc文件是否在 PKG_CONFIG_PATH或默认路径（/usr/lib/pkgconfig）。
[*]版本冲突：使用 --exact-version或 --max-version限制版本范围
pkg-config在cmake中使用
1. 基础使用流程
步骤 1：启用 PkgConfig 模块
在 CMakeLists.txt中调用 find_package加载 PkgConfig模块：
cmake_minimum_required(VERSION 3.10)
project(MyProject LANGUAGES CXX)
find_package(PkgConfig REQUIRED)# 确保系统已安装 pkg-config步骤 2：查找依赖库
使用 pkg_check_modules或 pkg_search_module定位库：
[*]pkg_check_modules：要求所有指定库均存在（严格匹配）。
[*]pkg_search_module：只需匹配列表中任意一个库（宽松匹配）。
# 查找 GTK 3.0 和 Glib 2.0（两者必须存在）
pkg_check_modules(GTK3 REQUIRED gtk+-3.0 glib-2.0)
<h1 id="查找-zeromq任一别名匹配即可">查找 ZeroMQ（任一别名匹配即可）</h1>
<p>pkg_search_module(ZeroMQ REQUIRED IMPORTED_TARGET libzeromq libzmq)
</p>
步骤 3：链接库到目标
使用生成的变量或导入目标（推荐）配置编译选项：
add_executable(my_app main.cpp)
# 传统变量方式
target_include_directories(my_app PRIVATE ${GTK3_INCLUDE_DIRS})
target_link_libraries(my_app PRIVATE ${GTK3_LIBRARIES})
[*]使用target_include_directories时，权限是必要的，PRIVATE INTERFACE PIUBLIC
[*]对于target_link_libraries，权限是非必要的
[*]GTK3_INCLUDE_DIRS与GTK3_LIBRARIES是根据步骤2查找依赖库时定义的变量名作为前缀生成的两个变量，其分别存储了查找到的库的头文件路径列表和链接库列表。
2 . 配置 PKG_CONFIG_PATH
若依赖库安装在非标准路径（如 /usr/local/lib），需通过环境变量扩展搜索路径：
# 在 CMakeLists.txt 中临时设置
set(ENV{PKG_CONFIG_PATH} "/custom/path/lib/pkgconfig:$ENV{PKG_CONFIG_PATH}")或在终端中设置：
export PKG_CONFIG_PATH="/custom/path/lib/pkgconfig:$PKG_CONFIG_PATH"此操作确保 pkg-config能定位到自定义安装的 .pc文件。
3 . 高级特性与技巧
静态链接
通过 --static标志获取静态库链接选项：
pkg_check_modules(GTK3_STATIC REQUIRED IMPORTED_TARGET gtk+-3.0)
set_target_properties(PkgConfig::GTK3_STATIC PROPERTIES INTERFACE_LINK_LIBRARIES "${GTK3_STATIC_STATIC_LDFLAGS}")版本控制
检查依赖库的版本兼容性：
pkg_check_modules(GLIB REQUIRED glib-2.0>=2.60)若版本低于 2.60，配置将失败。
依赖传递
.pc文件中的 Requires字段声明依赖关系，pkg-config会自动递归解析。例如 harfbuzz.pc依赖 freetype2，生成的变量会包含所有层级依赖的编译参数。
4 . 常见问题与解决
[*]错误：Package not found
[*]确认库的开发包已安装（如 libzmq-dev）。
[*]检查 .pc文件是否在 PKG_CONFIG_PATH或默认路径（/usr/lib/pkgconfig）。
[*]CMake 版本兼容性
IMPORTED_TARGET要求 CMake ≥ 3.6，低版本需手动配置变量。
[*]与 find_package的选用原则
[*]优先使用库提供的 Config.cmake（find_package）。
[*]若无 CMake 支持，则用 pkg-config（尤其适用于 Linux 常见库如 GTK、OpenSSL）。
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！
页:
[1]