A
Air官方
交叉编译环境下，依赖探测层（pkg-config 为核心）是出错率最高的环节之一。这篇讲桩与探测的治理——让构建系统正确找到你要它找的东西，找不到的也别误报。
▍pkg-config 的工作方式
构建系统问 pkg-config 两件事：这库存在吗（找 pc 文件），用什么参数（读 pc 文件里的头文件路径、库路径、依赖链）。pc 文件本质是一小段声明文本，这给了我们完全的控制权：库在什么位置、带什么依赖，都能手工写。
▍桩的两种用途
用途一，补 pc：预编译栈里有的库没带 pc 文件，照着官方格式手写一份，指向真实路径——这是最干净的补法。用途二，桩库：某个桌面依赖（如 dbus）目标环境没有也不想编，编一个空实现桩库加配套 pc 文件，链接通过、运行时短路——桌面服务依赖的通用驯法。桩要记录清单：桩了什么、桩了哪些符号，将来排查行为异常先翻桩清单。
▍探测误报的治理
探测层的危险不是找不到，而是找到了错的。三类高发：找到了宿主系统的同名库（查找路径漏配，编出 x86 混入 arm64 产物）；找到了另一个前缀的旧版本（路径顺序错）；探测脚本运行了目标二进制成功返回假数据（交叉下测试程序跑不了，脚本误判）。治理：探测环境变量只含目标前缀；升级后清构建缓存；对关键依赖在 configure 输出里核对找到的版本与路径。
▍常见错误
一，PKG_CONFIG_PATH 与 PKG_CONFIG_LIBDIR 混用：交叉下用 LIBDIR 限制搜索根更干净。二，pc 文件里的路径是绝对路径且含机器特有目录：换机器就断，写前缀相对式或生成时替换。三，多 pc 同名：加版本后缀区分并显式指定（带版本号请求）。
▍建议
工程里维护一份依赖清单表：每个依赖的来源（自编、栈取、桩化）、pc 状态、版本。这张表是拼接层唯一的真相源。
更多真实移植案例，欢迎到 apps 板块翻看 56 篇《鸿蒙PC适配全记录》系列实录。
▍pkg-config 的工作方式
构建系统问 pkg-config 两件事：这库存在吗（找 pc 文件），用什么参数（读 pc 文件里的头文件路径、库路径、依赖链）。pc 文件本质是一小段声明文本，这给了我们完全的控制权：库在什么位置、带什么依赖，都能手工写。
▍桩的两种用途
用途一，补 pc：预编译栈里有的库没带 pc 文件，照着官方格式手写一份，指向真实路径——这是最干净的补法。用途二，桩库：某个桌面依赖（如 dbus）目标环境没有也不想编，编一个空实现桩库加配套 pc 文件，链接通过、运行时短路——桌面服务依赖的通用驯法。桩要记录清单：桩了什么、桩了哪些符号，将来排查行为异常先翻桩清单。
▍探测误报的治理
探测层的危险不是找不到，而是找到了错的。三类高发：找到了宿主系统的同名库（查找路径漏配，编出 x86 混入 arm64 产物）；找到了另一个前缀的旧版本（路径顺序错）；探测脚本运行了目标二进制成功返回假数据（交叉下测试程序跑不了，脚本误判）。治理：探测环境变量只含目标前缀；升级后清构建缓存；对关键依赖在 configure 输出里核对找到的版本与路径。
▍常见错误
一，PKG_CONFIG_PATH 与 PKG_CONFIG_LIBDIR 混用：交叉下用 LIBDIR 限制搜索根更干净。二，pc 文件里的路径是绝对路径且含机器特有目录：换机器就断，写前缀相对式或生成时替换。三，多 pc 同名：加版本后缀区分并显式指定（带版本号请求）。
▍建议
工程里维护一份依赖清单表：每个依赖的来源（自编、栈取、桩化）、pc 状态、版本。这张表是拼接层唯一的真相源。
更多真实移植案例，欢迎到 apps 板块翻看 56 篇《鸿蒙PC适配全记录》系列实录。
楼主
7 天前