xmake v2.5.2 发布, 支持自动拉取交叉工具链和依赖包集成-Windows系列-PHP中文网

xmake 是一个基于 lua 的轻量级跨平台构建工具，使用 xmake.lua 文件维护项目构建。相比 makefile/cmakelists.txt，xmake 的配置语法更加简洁直观，对新手非常友好，短时间内即可快速上手，让用户能够将更多精力集中在实际的项目开发上。

在 2.5.2 版本中，xmake 增加了一个重量级的新特性：自动拉取远程交叉编译工具链。这个功能对于有过交叉编译和 C/C++ 项目移植经验的开发者来说尤为重要，因为配置和下载交叉编译工具链是一个复杂且容易出错的过程。现在，xmake 可以自动下载项目所需的工具链，并使用这些工具链直接编译项目，用户无需关心如何配置工具链，只需执行

xmake

登录后复制

命令即可完成编译。

xmake v2.5.2 发布, 支持自动拉取交叉工具链和依赖包集成

不仅如此，对于 C/C++ 依赖包的集成，xmake 也可以自动切换到对应工具链进行编译和安装，整个过程完全自动化，用户无需手动干预。

除了交叉编译工具链，xmake 还可以自动拉取其他工具链，例如特定版本的 llvm、llvm-mingw 和 zig 等，用于参与 C/C++/Zig 项目的编译。即使是 cmake 也不支持工具链的自动拉取，顶多只能配合 vcpkg/conan 等第三方包管理工具对 C/C++ 依赖包进行集成，而 xmake 则内置了自己的包管理工具，无需任何外部依赖。

从 2.5.2 版本开始，xmake 支持拉取指定的工具链来集成编译项目，并且可以将依赖包切换到对应的远程工具链进行编译后集成。目前，xmake-repo 仓库中已经收录了以下工具链包：llvm、llvm-mingw、gnu-rm、muslcc 和 zig。虽然目前支持的工具链包数量有限，但整体架构已经打通，后续将收录更多的工具链，如 gcc、tinyc 和 vs-buildtools 等。

由于 xmake 的包支持语义版本，如果项目依赖特定版本的 gcc/clang 编译器，xmake 会自动检测当前系统的 gcc/clang 版本是否满足需求。如果版本不满足，xmake 会自动拉取并安装特定版本的 gcc/clang，然后再进行项目编译。

以下是使用特定版本的 llvm 工具链（例如 llvm-10）编译项目的示例代码：

add_requires("llvm 10.x", {alias = "llvm-10"})
target("test")
    set_kind("binary")
    add_files("src/*.c")
    set_toolchains("llvm@llvm-10")

登录后复制

其中，

llvm@llvm-10

登录后复制

中的前半部分为工具链名，后半部分为需要关联的工具链包名。如果设置了别名，则优先使用别名

llvm-10

登录后复制

。

后续还将增加 gcc 工具链包到 xmake-repo，使得用户可以自由切换到 gcc-10、gcc-11 等特定版本的 gcc 编译器，而无需手动安装。

以下是拉取指定的交叉编译工具链（例如 muslcc）来编译项目的示例代码：

add_requires("muslcc")
target("test")
    set_kind("binary")
    add_files("src/*.c")
    set_toolchains("@muslcc")

登录后复制

muslcc 是 https://www.php.cn/link/3f54e27d6a63e1397fe94938013a9161 提供的一款交叉编译工具链，默认 xmake 会自动集成编译

x86_64-linux-musl-

登录后复制

目标平台。当然，也可以通过

xmake f -a arm64

登录后复制

切换到

aarch64-linux-musl-

登录后复制

目标平台进行交叉编译。

使用指定的 muslcc 交叉编译工具链去编译和集成所有的依赖包的示例代码如下：

add_requires("muslcc")
add_requires("zlib", "libogg", {system = false})
set_toolchains("@muslcc")
target("test")
    set_kind("binary")
    add_files("src/*.c")
    add_packages("zlib", "libogg")

登录后复制

此时，工程中配置的 zlib、libogg 等依赖包会切换使用 muslcc 工具链，自动下载编译然后集成进来。也可以通过

set_plat/set_arch

登录后复制

固定平台，只需一个 xmake 命令即可完成整个交叉编译环境的集成以及架构切换。

拉取并集成特定版本的 zig 工具链的示例代码如下：

add_rules("mode.debug", "mode.release")
add_requires("zig 0.7.x")
target("test")
    set_kind("binary")
    add_files("src/*.zig")
    set_toolchains("@zig")

登录后复制

xmake 会先下载特定版本的 zig 工具链，然后使用此工具链编译 zig 项目。如果用户已经自行安装了 zig 工具链，xmake 会自动检测对应版本是否满足需求，如果满足则直接使用，无需重复下载安装。

zig cc

登录后复制

是 zig 内置的 C/C++ 编译器，可以独立进行 C/C++ 代码的编译和链接，完全不依赖 gcc/clang/msvc，非常强大。使用

zig cc

登录后复制

编译 C/C++ 项目的示例如下：

$ xmake f --toolchain=zig
$ xmake
[ 25%]: compiling.release src/main.c
"zig cc" -c -arch x86_64 -fvisibility=hidden -O3 -DNDEBUG -o build/.objs/xmake_test/macosx/x86_64/release/src/main.c.o src/main.c
[ 50%]: linking.release test
"zig c++" -o build/macosx/x86_64/release/test build/.objs/xmake_test/macosx/x86_64/release/src/main.c.o -arch x86_64 -stdlib=libc++ -Wl,-x -lz
[100%]: build ok!

登录后复制

zig cc

登录后复制

还支持不同架构的交叉编译，例如在 macOS 上交叉编译 windows/x64 目标程序，替代了 mingw 的功能：

自由画布

百度文库和百度网盘联合开发的AI创作工具类智能体

查看详情

$ xmake f -p windows -a x64 --toolchain=zig
$ xmake

登录后复制

xmake 还提供了类似于 cmake 中

WINDOWS_EXPORT_ALL_SYMBOLS

登录后复制

的特性，可以快速全量导出 windows/dll 中的符号，简化对第三方项目移植过程中对符号导出的处理。配置

utils.symbols.export_all

登录后复制

规则即可实现这一功能：

target("foo")
    set_kind("shared")
    add_files("src/foo.c")
    add_rules("utils.symbols.export_all")
target("test")
    set_kind("binary")
    add_deps("foo")
    add_files("src/main.c")

登录后复制

xmake 还提供了将 MinGW 生成的动态库（xxx.dll & xxx.dll.a）转换成 Visual Studio 可以识别的格式（xxx.dll & xxx.lib）的功能，参考自 CMAKE_GNUtoMS 功能。这一功能对 Fortran & C++ 混合项目特别有帮助，可以使用如下辅助模块接口：

import("utils.platform.gnu2mslib")
gnu2mslib("xxx.lib", "xxx.dll.a")
gnu2mslib("xxx.lib", "xxx.def")
gnu2mslib("xxx.lib", "xxx.dll.a", {dllname = "xxx.dll", arch = "x64"})

登录后复制

为了简化用户自定义 rule 的配置，xmake 新提供了

on_buildcmd_file

登录后复制

和

on_buildcmd_files

登录后复制

等自定义脚本入口，可以通过 batchcmds 对象构造一个批处理命令行任务，xmake 在实际执行构建时一次性执行这些命令。这对于

xmake project

登录后复制

此类工程生成器插件非常有用，因为生成器生成的第三方工程文件不支持

on_build_files

登录后复制

此类内置脚本的执行支持。

以下是使用

on_buildcmd_file

登录后复制

构造批处理命令的示例：

rule("foo")
    set_extensions(".xxx")
    on_buildcmd_file(function (target, batchcmds, sourcefile, opt)
        batchcmds:vrunv("gcc", {"-o", objectfile, "-c", sourcefile})
    end)

登录后复制

除了

batchcmds:vrunv

登录后复制

，还支持其他批处理命令，例如：

batchcmds:show("hello %s", "xmake")
batchcmds:vrunv("gcc", {"-o", objectfile, "-c", sourcefile}, {envs = {LD_LIBRARY_PATH="/xxx"}})
batchcmds:mkdir("/xxx") -- and cp, mv, rm, ln ..
batchcmds:compile(sourcefile_cx, objectfile, {configs = {includedirs = sourcefile_dir, languages = (sourcekind == "cxx" and "c++11")}})
batchcmds:link(objectfiles, targetfile, {configs = {linkdirs = ""}})

登录后复制

以下是一个完整的示例，展示了如何使用

on_buildcmd_file

登录后复制

实现 lex 规则：

rule("lex")
    set_extensions(".l", ".ll")
    on_buildcmd_file(function (target, batchcmds, sourcefile_lex, opt)
        -- imports
        import("lib.detect.find_tool")
        -- get lex
        local lex = assert(find_tool("flex") or find_tool("lex"), "lex not found!")
        -- get c/c++ source file for lex
        local extension = path.extension(sourcefile_lex)
        local sourcefile_cx = path.join(target:autogendir(), "rules", "lex_yacc", path.basename(sourcefile_lex) .. (extension == ".ll" and ".cpp" or ".c"))
        -- add objectfile
        local objectfile = target:objectfile(sourcefile_cx)
        table.insert(target:objectfiles(), objectfile)
        -- add commands
        batchcmds:show_progress(opt.progress, "${color.build.object}compiling.lex %s", sourcefile_lex)
        batchcmds:mkdir(path.directory(sourcefile_cx))
        batchcmds:vrunv(lex.program, {"-o", sourcefile_cx, sourcefile_lex})
        batchcmds:compile(sourcefile_cx, objectfile)
        -- add deps
        batchcmds:add_depfiles(sourcefile_lex)
        batchcmds:set_depmtime(os.mtime(objectfile))
        batchcmds:set_depcache(target:dependfile(objectfile))
    end)

登录后复制

关于依赖包配置的改进，xmake 新增了

add_extsources

登录后复制

和

on_fetch

登录后复制

两个配置接口，可以更好的配置 xmake 在安装 C/C++ 包的过程中，对系统库的查找过程。例如，通过

add_extsources("pkgconfig::libusb-1.0")

登录后复制

改进查找逻辑，使 xmake 能够找到通过

apt install libusb-1.0

登录后复制

安装的系统库：

package("libusb")
    add_extsources("pkgconfig::libusb-1.0")
    on_install(function (package)
        -- ...
    end)

登录后复制

如果需要更复杂的查找逻辑，可以使用

on_fetch

登录后复制

完全定制化查找系统库逻辑，例如：

package("libusb")
    on_fetch("linux", function(package, opt)
        if opt.system then
            return find_package("pkgconfig::libusb-1.0")
        end
    end)

登录后复制

在新版本中，xmake 还新增了对 windows

.manifest

登录后复制

文件的支持，只需通过

add_files

登录后复制

添加即可：

add_rules("mode.debug", "mode.release")
target("test")
    set_kind("binary")
    add_files("src/*.cpp")
    add_files("src/*.manifest")

登录后复制

关于 xrepo 命令的改进，现在可以通过

xrepo remove --all

登录后复制

命令批量卸载删除已经安装的包，支持模式匹配：

$ xrepo remove --all
$ xrepo remove --all zlib pcr*

登录后复制

最后，xmake 改进了

add_packages

登录后复制

，使其支持

{public = true}

登录后复制

来导出包配置给父 target。例如：

add_rules("mode.debug", "mode.release")
add_requires("pcre2")
target("test")
    set_kind("shared")
    add_packages("pcre2", {public = true})
    add_files("src/test.cpp")
target("demo")
    add_deps("test")
    set_kind("binary")
    add_files("src/main.cpp")
    -- 我们可以在这里使用被 test 目标导出的 pcre2 库

登录后复制

具体导出的配置如下：

-- 默认私有，但是 links/linkdirs 还是会自动导出
add_packages("pcre2")
-- 全部导出，包括 includedirs, defines
add_packages("pcre2", {public = true})

登录后复制

更新内容包括以下新特性：

支持
```
zig cc
```
登录后复制
和
```
zig c++
```
登录后复制
作为 C/C++ 编译器
支持使用 zig 进行交叉编译
改进终端和 color codes 探测
传递自定义 includes 脚本给 xrepo
添加 linuxos 内置模块获取 linux 系统信息
支持在编译项目时自动拉取工具链
添加
```
rule("utils.symbols.export_all")
```
登录后复制
自动导出所有 windows/dll 中的符号
添加
```
utils.platform.gnu2mslib(mslib, gnulib)
```
登录后复制
模块接口去转换 mingw/xxx.dll.a 到 msvc xxx.lib
改进规则支持新的批处理命令去简化自定义规则实现
添加
```
add_extsources
```
登录后复制
去改进外部包的查找
支持为 windows 程序添加 .manifest 文件参与链接
支持使用
```
xrepo remove --all
```
登录后复制
命令去移除所有的包，并且支持模式匹配
支持导出包配置给父 target，实现包配置的依赖继承