build2 库构建与链接实战静态库、动态库与 pkg-config 集成【免费下载链接】build2build2 build system项目地址: https://gitcode.com/gh_mirrors/bu/build2build2 是一个开源MIT 许可、跨平台的 C/C 构建工具链用它来构建和链接静态库、动态库并自动生成 pkg-config 文件比手写 Makefile 简单得多。本文面向新手用最少的代码带你快速上手从创建一个库项目、分别产出静态库与共享库到安装后自动集成 pkg-config全程实战演示。build2 是什么为什么适合构建库项目build2 不仅是一个构建系统还内置了包管理和项目管理能力被设计用来开发和打包复杂的 C/C 项目。对于库开发者来说build2 最有价值的一点是它能根据库目标自动生成 pkg-config 文件省去了手工维护.pc文件的烦恼。在 build2 中库目标类型非常直观liba{}静态库.a/.liblibs{}共享库 / 动态库.so/.dlllib{}抽象库构建时自动选择静态或共享libue{}/libul{}库的可用性成员用于携带编译选项和链接选项第一步创建你的第一个库项目假设我们要做一个名为libhello的库。先初始化项目结构mkdir libhello cd libhello在项目根目录创建build/bootstrap.build和build/root.build两个文件# build/bootstrap.build project libhello using config using test# build/root.build cxx.std latest using cxx然后创建一个源码子目录libhello/并在其中放置头文件和源文件hello.hxx、export.hxx、hello.cxx再加上一个buildfile# libhello/buildfile lib{hello}: {hxx cxx}{**} hxx{*}: extension hxx cxx{*}: extension cxx这里lib{hello}就是一个抽象库目标它包含了目录下所有头文件和源文件。build2 会自动为你决定构建静态库还是共享库也可以通过命令行指定。第二步静态库与动态库的构建方法在默认配置下b configure会根据平台选择库类型Linux 上通常优先共享库。如果你想显式构建静态库可以在命令行指定b configure config.libhello.libstatic b库的静态与动态变体还可以并存。build2 对库目标类型做了精细的拆分这在官方测试用例中体现得很清楚例如 tests/cc/libu/testscript 中同时声明了liba{foo}静态和libs{foo}共享./: exe{foo}: cxx{driver} libue{foo} ./: liba{foo}: libua{foo} ./: libs{foo}: libus{foo}构建完成后在out/目录下你会看到libhello.a静态库libhello.so→libhello-0.1.so共享库及符号链接第三步安装库并自动生成 pkg-config 文件这是 build2 最省心的环节。库构建好后一条命令即可安装b install config.install.root/tmp/install/安装完成后目录结构大致如下参考 doc/manual.cli 中的示例/tmp/install/ ├── include/ │ └── libhello/ │ ├── hello.hxx │ ├── export.hxx │ └── version.hxx ├── lib/ │ ├── pkgconfig/ │ │ ├── libhello.pc │ │ ├── libhello.shared.pc │ │ └── libhello.static.pc │ ├── libhello.a │ ├── libhello.so - libhello-0.1.so │ └── libhello-0.1.so └── share/ └── doc/可以看到build2 的链接规则libbuild2/cc/link-rule.cxx会自动为你的库生成三种 pkg-config 文件libhello.pc通用版本libhello.shared.pc共享库专用libhello.static.pc静态库专用会带上静态链接所需的依赖这正是 libbuild2/cc/pkgconfig.cxx 模块的工作你无需手写任何.pc文件。第四步自定义 pkg-config 的 include 路径与链接参数默认生成的.pc文件会用标准路径。如果库的公共头文件放在子目录中可以用cc.pkgconfig.include变量指定示例同样来自 doc/manual.clilib{hello}: cxx.pkgconfig.include include/hello/对于链接参数可以使用cxx.pkgconfig.lib变量。例如静态库往往需要额外链接系统库lib{hello}: cxx.pkgconfig.lib -lz生成的libhello.static.pc就会自动带上-lz下游用户直接用pkg-config就能拿到完整的链接参数。第五步下游项目如何链接这个库下游用户有两种方式使用你的库非常灵活。方式一作为安装好的库导入自动读取 pkg-config当 build2 无法在源码树中找到项目时链接规则会自动去编译器的库搜索路径中查找已安装的库并且如果发现对应的 pkg-config 文件会自动提取额外的编译和链接参数。这意味着安装后的库即使不是 build2 项目也能被正常导入使用。# 下游项目的 buildfile import libs libhello%lib{hello} exe{greet}: cxx{greet} $libs方式二手动编译验证安装完成后的库也能被传统编译方式直接使用g -I/tmp/install/include -L/tmp/install/lib greet.cxx -lhello或者通过 pkg-config 获取参数g $(pkg-config --cflags --libs libhello) greet.cxx常用配置速查表目的命令 / 变量构建静态库b configure config.libhello.libstatic构建共享库b configure config.libhello.libshared指定安装根目录b install config.install.root/usr/local/自定义 .pc 头文件路径cxx.pkgconfig.include include/hello/自定义 .pc 链接参数cxx.pkgconfig.lib -lz调整 pkgconfig 安装目录config.install.pkgconfig小结通过本文的实战你已经掌握了 build2 构建库的核心流程用lib{}声明库目标、通过liba{}/libs{}区分静态与动态库、用b install一键安装并让 build2 自动生成并集成 pkg-config 文件。这套机制让库的发布和消费都变得异常简单无论是自己项目内部复用还是对外发布给其他构建系统的用户都能平滑衔接。想深入了解实现细节可以阅读 libbuild2/cc/init.hxx模块加载与变量注册和 libbuild2/cc/pkgconfig.hxxpkg-config 生成逻辑。动手试试吧下一个高质量 C 库项目就用 build2 来构建【免费下载链接】build2build2 build system项目地址: https://gitcode.com/gh_mirrors/bu/build2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考