xmake v2.5.3 发布，支持构建 linux bpf 程序和 Conda 包集成

时间  2021-08-12
标签 linux android ios c++ git es6 github bootstrap windows api 栏目 Linux 繁體版
原文   原文链接

xmake 是一个基于 Lua 的轻量级跨平台构建工具，使用 xmake.lua 维护项目构建，相比 makefile/CMakeLists.txt，配置语法更加简洁直观，对新手很是友好，短期内就能快速入门，可以让用户把更多的精力集中在实际的项目开发上。linux

在 2.5.3 版本，咱们新增了对 linux bpf 程序的构建支持，而且同时支持 android bpf 程序的构建。android

尽管 bpf 对 编译工具链有必定的要求，好比须要较新的 llvm/clang 和 android ndk 工具链，可是 xmake 可以自动拉取特定版本的 llvm/ndk 来用于编译，而且还能自动拉取 libbpf 等依赖库，彻底省去了用户折腾编译环境和 libbpf 库集成的问题。ios

另外，在新版本中咱们还新增了对 Conda 包仓库的集成支持，如今除了可以从 Conan/Vcpkg/brew/pacman/clib/dub 等包仓库集成使用包，还能从 Conda 包仓库中集成各类二进制 C/C++ 包。c++

新特性介绍

构建 Linux Bpf 程序

新版本，咱们开始支持 bpf 程序构建，同时支持 linux 以及 android 平台，可以自动拉取 llvm 和 android ndk 工具链。git

更多详情见：#1274es6

支持 linux 和 android 两端构建的配置大概以下，若是咱们不须要构建 android 版本，能够作一些删减，配置会更加精简：github

add_rules("mode.release", "mode.debug")
add_rules("platform.linux.bpf")

add_requires("linux-tools", {configs = {bpftool = true}})
add_requires("libbpf")
if is_plat("android") then
    add_requires("ndk >=22.x")
    set_toolchains("@ndk", {sdkver = "23"})
else
    add_requires("llvm >=10.x")
    set_toolchains("@llvm")
    add_requires("linux-headers")
end

target("minimal")
    set_kind("binary")
    add_files("src/*.c")
    add_packages("linux-tools", "linux-headers", "libbpf")
    set_license("GPL-2.0")
复制代码

经过上面的配置，大概能够看出，咱们集成配置了特定版本的 llvm 和 NDK 工具链，以及 libbpf, linux-headers, linux-tools 等包，xmake 都会去自动拉取它们，而后使用对应的工具链集成编译这些依赖包，最后生成 bpf 程序。bootstrap

其中 linux-tools 包主要使用了里面的 libtool 程序，用于生成 bpf skeleton 头文件，xmake 也会自动调用这个工具去生成它。windows

编译 linux bpf 程序

咱们只须要执行 xmake 命令便可完成编译，即便你还没安装 llvm/clang，固然，若是你已经安装了它们，若是版本匹配，xmake 也会去优先使用。api

$ xmake
复制代码

咱们也能够经过 xmake -v 来编译而且查看完整详细的编译命令：

$ xmake -v
[ 20%]: compiling.bpf src/minimal.bpf.c
/usr/bin/ccache /usr/bin/clang -c -Qunused-arguments -m64 -fvisibility=hidden -O3 -Ibuild/.gens/minimal/linux/x86_64/release/rules/bpf -isystem /home/ruki/.xmake/packages/l/linux-tools/5.9.16/0c52e491268946fe9a4bc91d4906d66b/include -isystem /home/ruki/.xmake/packages/z/zlib/1.2.11/3a7e4427eda94fc69fad0009a1629fd8/include -isystem /home/ruki/.xmake/packages/l/libelf/0.8.13/ced4fdd8151a475dafc5f51e2a031997/include -isystem /home/ruki/.xmake/packages/l/libelf/0.8.13/ced4fdd8151a475dafc5f51e2a031997/include/libelf -isystem /home/ruki/.xmake/packages/l/libcap/2.27/c55b28aa3b3745489b93895d0d606ed1/include -isystem /home/ruki/.xmake/packages/l/linux-headers/5.9.16/8e3a440cbe1f42249aef3d89f1528ecb/include -DNDEBUG -target bpf -g -o build/.gens/minimal/linux/x86_64/release/rules/bpf/minimal.bpf.o src/minimal.bpf.c
llvm-strip -g build/.gens/minimal/linux/x86_64/release/rules/bpf/minimal.bpf.o
bpftool gen skeleton build/.gens/minimal/linux/x86_64/release/rules/bpf/minimal.bpf.o
[ 40%]: ccache compiling.release src/minimal.c
/usr/bin/ccache /usr/bin/clang -c -Qunused-arguments -m64 -fvisibility=hidden -O3 -Ibuild/.gens/minimal/linux/x86_64/release/rules/bpf -isystem /home/ruki/.xmake/packages/l/linux-tools/5.9.16/0c52e491268946fe9a4bc91d4906d66b/include -isystem /home/ruki/.xmake/packages/z/zlib/1.2.11/3a7e4427eda94fc69fad0009a1629fd8/include -isystem /home/ruki/.xmake/packages/l/libelf/0.8.13/ced4fdd8151a475dafc5f51e2a031997/include -isystem /home/ruki/.xmake/packages/l/libelf/0.8.13/ced4fdd8151a475dafc5f51e2a031997/include/libelf -isystem /home/ruki/.xmake/packages/l/libcap/2.27/c55b28aa3b3745489b93895d0d606ed1/include -isystem /home/ruki/.xmake/packages/l/linux-headers/5.9.16/8e3a440cbe1f42249aef3d89f1528ecb/include -DNDEBUG -o build/.objs/minimal/linux/x86_64/release/src/minimal.c.o src/minimal.c
[ 60%]: linking.release minimal
/usr/bin/clang++ -o build/linux/x86_64/release/minimal build/.objs/minimal/linux/x86_64/release/src/minimal.c.o -m64 -L/home/ruki/.xmake/packages/l/linux-tools/5.9.16/0c52e491268946fe9a4bc91d4906d66b/lib64 -L/home/ruki/.xmake/packages/z/zlib/1.2.11/3a7e4427eda94fc69fad0009a1629fd8/lib -L/home/ruki/.xmake/packages/l/libelf/0.8.13/ced4fdd8151a475dafc5f51e2a031997/lib -L/home/ruki/.xmake/packages/l/libcap/2.27/c55b28aa3b3745489b93895d0d606ed1/lib -s -lbpf -lz -lelf -lcap
[100%]: build ok!
复制代码

编译 Android bpf 程序

若是编译 Android 版本，咱们也只须要切换到 android 平台便可，同样很方便

$ xmake f -p android
$ xmake
复制代码

xmake 会去自动下来 ndk 工具链和对应 android 版本 libbpf 等库来使用。

$ xmake f -p android -c
checking for architecture ... armeabi-v7a
checking for Android SDK directory ... no
checking for NDK directory ... no
note: try installing these packages (pass -y to skip confirm)?
in local-repo:
  -> libcap 2.27 [linux, x86_64, from:linux-tools]
  -> libelf 0.8.13 [linux, x86_64, from:linux-tools]
  -> zlib 1.2.11 [linux, x86_64, from:linux-tools]
  -> linux-tools 5.9.16 [bpftool:y]
  -> ndk 22.0
  -> libelf#1 0.8.13 [toolchains:@ndk, from:libbpf]
  -> zlib#1 1.2.11 [toolchains:@ndk, from:libbpf]
  -> libbpf v0.3 [toolchains:@ndk]
please input: y (y/n)

  => install libcap 2.27 .. ok
  => install zlib 1.2.11 .. ok
  => install libelf 0.8.13 .. ok
  => install ndk 22.0 .. ok
  => install linux-tools 5.9.16 .. ok
  => install libelf#1 0.8.13 .. ok
  => install zlib#1 1.2.11 .. ok
  => install libbpf v0.3 .. ok
ruki@010689392c4d:/mnt/bpf_minimal$ xmake
[ 20%]: compiling.bpf src/minimal.bpf.c
[ 40%]: ccache compiling.release src/minimal.c
[ 60%]: linking.release minimal
[100%]: build ok!
复制代码

固然，若是你已经手动下载了对应版本的 ndk 工具链，咱们也能够指定使用，再也不走自动拉取。

$ xmake f -p android --ndk=/xxx/android-ndk-r22
$ xmake
复制代码

不过，若是本身下载的话，记得至少要下载 ndk r22 以上版本的，由于低版本 ndk 里面的 clang 不支持编译生成 bpf 程序。

最后，这里有个完整的基于 xmake 的 bpf 脚手架工程，你们能够参考下：github.com/hack0z/libb…

另外这里也有个最小 bpf 例子程序：github.com/xmake-io/xm…

集成使用 Conda 包

Conda 是一个很强大的第三方包管理器，支持各类语言的二进制包拉取，这里咱们仅仅使用里面的 C/C++ 包。

它的集成使用方式跟 conan/vcpkg 相似，仅仅只是包命名空间改为了 conda::

add_requires("conda::libpng 1.6.37", {alias = "libpng"})
add_requires("conda::openssl")
target("testco")
    set_kind("binary")
    add_files("src/*.cpp")
    add_packages("libpng", "conda::openssl")
复制代码

注：虽然咱们支持不少的第三方包管理器，好比 conan/conda/vcpkg/brew 等等，可是 xmake 也有自建的包仓库管理，目前已有将近 300 个经常使用包，支持不一样的平台，其中部分包还支持 android/ios/mingw 甚至交叉编译环境。

所以，若是官方 xmake-repo 仓库已经提供了须要的包，能够直接使用，不须要指定包命名空间。xmake 对第三方包管理的支持仅仅是做为补充，尽量复用已有 c/c++ 生态，避免生态碎片化。

获取主机 cpu 信息

当前版本，咱们新增了一个 core.base.cpu 模块和 os.cpuinfo 接口，用于获取 cpu 的各类信息，好比：cpu family/model, microarchitecture，core number, features 等信息。

这一般在追求性能的项目中很是有用，这些项目一般须要根据CPU的内存模型和扩展指令集来优化，同时想要跨平台的话，就须要根据当前cpu信息指定对应的代码，（例如intel haswell以后一套，amd zen以后一套，更老的默认到没有优化）。不少高性能计算库里面也会用到这些信息。

所以，经过这个模块接口就能够在编译配置的时候获取当前主机 cpu 的信息和特性支持力度，来针对性开启相关优化编译。

咱们能够经过 os.cpuinfo() 快速获取全部信息，也能够指定 os.cpuinfo("march") 获取特定信息，好比 march，也就是 microarchitecture

咱们也能够经过 xmake l 命令来快速查看获取结果。

$ xmake l os.cpuinfo
{
  features = "fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clfsh ds acpi mmx fxsr sse sse2 ss htt tm pbe sse3 pclmulqdq dtes64 mon dscpl vmx est tm2 ssse3 fma cx16 tpr pdcm sse4_1 sse4_2 x2apic movbe popcnt aes pcid xsave osxsave seglim64 tsctmr avx1_0 rdrand f16c",
  vendor = "GenuineIntel",
  model_name = "Intel(R) Core(TM) i7-8569U CPU @ 2.80GHz",
  family = 6,
  march = "Kaby Lake",
  model = 142,
  ncpu = 8
}

$ xmake l os.cpuinfo march
"Kaby Lake"

$ xmake l os.cpuinfo ncpu
8
复制代码

若是要判断 sse 等扩展特性支持，就得须要 import 导入 core.base.cpu 模块来获取了。

target("test")
    set_kind("binary")
    add_files("src/*.c")
    on_load(function (target)
        import("core.base.cpu")
        local ncpu = os.cpuinfo("ncpu")
        -- local ncpu = cpu.number()
        if cpu.has_feature("sse") then
            target:add("defines", "HAS_SSE")
        end
    end)
复制代码

新增 cmake 导入文件规则

若是，咱们开发的是库程序，在执行 xmake install 安装到系统后，仅仅只安装了库文件，没有 .cmake/.pc 等导入文件信息，所以 cmake 工程想经过 find_package 集成使用，一般是找不到咱们的库。

为了可以让第三方 cmake 工程正常找到它并使用集成，那么咱们可使用 utils.install.cmake_importfiles 规则在安装 target 目标库文件的时候，导出 .cmake 文件，用于其余 cmake 项目的库导入和查找。

咱们只须要经过 add_rules 接口应用此规则到指定的 target 库目标便可。

target("test")
    set_kind("binary")
    add_files("src/*.c")
    add_rules("utils.install.cmake_importfiles")
复制代码

配置以后，xmake install 安装命令就可以自动导出 .cmake 导入文件。

新增 pkgconfig 导入文件规则

跟上面的 cmake 导入相似，只不过咱们这也能够经过 utils.install.pkgconfig_importfiles 规则安装 pkgconfig/.pc 导入文件，这对 autotools 等工具的库探测很是有用。

target("test")
    set_kind("binary")
    add_files("src/*.c")
    add_rules("utils.install.pkgconfig_importfiles")
复制代码

新增 Git 相关内置配置变量

xmake 一直有提供 config.h 的自动生成特性，能够经过 add_configfiles 接口来配置，而且它还支持模板变量的替换，用户能够本身定义一些变量。

不过，xmake 也提供了一些经常使用的内置变量替换，好比 版本信息，平台架构等。具体详情见：xmake.io/#/manual/pr…

模板配置使用方式很简单，只须要：

target("test")
    set_kind("binary")
    add_files("src/*.c")
    add_configfiles("src/config.h.in")
复制代码

就能根据 config.h.in 自动生成 config.h 文件。

不过咱们这里要讲的新特性是最近新提供的 Git 相关内置变量，来让用户在项目编译时候，快速方便的或者当前 git 项目最近的 tag/branch/commit 信息。

这对于后期排查定位问题很是有用，咱们能够经过 commit 精肯定位问题库是基于哪次 commit 提交致使的，这样，咱们就能 checkout 但对应版原本排查问题。

咱们只须要在 config.h.in 中配置定义如下变量。

#define GIT_COMMIT "${GIT_COMMIT}"
#define GIT_COMMIT_LONG "${GIT_COMMIT_LONG}"
#define GIT_COMMIT_DATE "${GIT_COMMIT_DATE}"
#define GIT_BRANCH "${GIT_BRANCH}"
#define GIT_TAG "${GIT_TAG}"
#define GIT_TAG_LONG "${GIT_TAG_LONG}"
#define GIT_CUSTOM "${GIT_TAG}-${GIT_COMMIT}"
复制代码

执行 xmake 编译，就会自动生成以下 config.h 文件。

#define GIT_COMMIT "8c42b2c2"
#define GIT_COMMIT_LONG "8c42b2c251793861eb85ffdf7e7c2307b129c7ae"
#define GIT_COMMIT_DATE "20210121225744"
#define GIT_BRANCH "dev"
#define GIT_TAG "v1.6.6"
#define GIT_TAG_LONG "v1.6.6-0-g8c42b2c2"
#define GIT_CUSTOM "v1.6.6-8c42b2c2"
复制代码

咱们就能够在程序用经过宏定义的方式使用它们。

Android NDK r22 支持和远程拉取

Android NDK 从 r22 以后，结构上作了很是大的改动，移除了一些被废弃的目录，好比 顶层的 sysroot 目录 和 platforms 目录，致使 xmake 以前的探测方式失效。

所以在新版本中，咱们对 xmake 作了改进来更好的支持全版本 NDK 工具链，包括 r22 以上的新版本。

同时 xmae-repo 官方仓库也增长了对 ndk 包的收录，使得 xmake 可以远程拉取 ndk 工具链来使用。

add_requires("ndk >=22.x")
set_toolchains("@ndk", {sdkver = "23"})
target("test")
    set_kind("binary")
    add_files("src/*.c")
复制代码

更新内容

新特性

  • #1259: 支持 add_files("*.def") 添加 def 文件去导出 windows/dll 符号
  • #1267: 添加 find_package("nvtx")
  • #1274: 添加 platform.linux.bpf 规则去构建 linux/bpf 程序
  • #1280: 支持 fetchonly 包去扩展改进 find_package
  • 支持自动拉取远程 ndk 工具链包和集成
  • #1268: 添加 utils.install.pkgconfig_importfiles 规则去安装 *.pc 文件
  • #1268: 添加 utils.install.cmake_importfiles 规则去安装 *.cmake 导入文件
  • #348: 添加 platform.longpaths 策略去支持 git longpaths
  • #1314: 支持安装使用 conda 包
  • #1120: 添加 core.base.cpu 模块而且改进 os.cpuinfo()
  • #1325: 为 add_configfiles 添加内建的 git 变量

改进

  • #1275: 改进 vsxmake 生成器，支持条件化编译 targets
  • #1290: 增长对 Android ndk r22 以上版本支持
  • #1311: 为 vsxmake 工程添加包 dll 路径，确保调试运行加载正常

Bugs 修复

  • #1266: 修复在 add_repositories 中的 repo 相对路径
  • #1288: 修复 vsxmake 插件处理 option 配置问题

tboox.org/cn/2021/04/…

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程