Xmake 是一个基于 Lua 的轻量级跨平台构建工具。
它非常的轻量,没有任何依赖,因为它内置了 Lua 运行时。
它使用 xmake.lua 维护项目构建,相比 makefile/CMakeLists.txt,配置语法更加简洁直观,对新手非常友好,短时间内就能快速入门,能够让用户把更多的精力集中在实际的项目开发上。
我们能够使用它像 Make/Ninja 那样可以直接编译项目,也可以像 CMake/Meson 那样生成工程文件,另外它还有内置的包管理系统来帮助用户解决 C/C++ 依赖库的集成使用问题。
目前,Xmake 主要用于 C/C++ 项目的构建,但是同时也支持其他 native 语言的构建,可以实现跟 C/C++ 进行混合编译,同时编译速度也是非常的快,可以跟 Ninja 持平。
Xmake = Build backend + Project Generator + Package Manager + [Remote|Distributed] Build + Cache
尽管不是很准确,但我们还是可以把 Xmake 按下面的方式来理解:
Xmake ≈ Make/Ninja + CMake/Meson + Vcpkg/Conan + distcc + ccache/sccache
- 项目源码
- 官方文档
- 入门课程
新特性介绍
这个版本,我们新增了不少实用的 API,并且移除了一些几年前就被标记为废弃的接口,另外改进了动态库对 soname 的支持。
同时,在这期间,我们迎来了一些喜人的数据,我们的 xmake-repo 官方仓库包的数量也突破了 1k,非常感谢 Xmake 的每位贡献者,我们的包仓库基本上都是社区贡献者贡献进来的。
尤其是 @xq114, @star-hengxing, @SirLynix 帮忙贡献了大量的包,非常感谢~
还有,Xmake 仓库 Commits 也突破到了 12k,一直在持续快速迭代中。下面我们简单介绍下,新版本中的一些主要更新内容。
增加 soname 支持
新版本中,我们对 set_version
接口新增了 soname 版本支持,用于控制 so/dylib 动态库的版本兼容性控制。
我们可以配置 soname 的版本后缀名称,xmake 会在编译、安装动态库的时候,自动生成符号链接,执行指定版本的动态库。
例如,如果我们配置:
set_version("1.0.1", {soname = true})
xmake 会自动解析版本号的 major 版本作为 soname 版本,生成的结构如下:
└── lib
├── libfoo.1.0.1.dylib
├── libfoo.1.dylib -> libfoo.1.0.1.dylib
└── libfoo.dylib -> libfoo.1.dylib
当然,我们也可以指定 soname 到特定的版本命名:
set_version("1.0.1", {soname = "1.0"}) -> libfoo.so.1.0, libfoo.1.0.dylib
set_version("1.0.1", {soname = "1"}) -> libfoo.so.1, libfoo.1.dylib
set_version("1.0.1", {soname = "A"}) -> libfoo.so.A, libfoo.A.dylib
set_version("1.0.1", {soname = ""}) -> libfoo.so, libfoo.dylib
而如果没设置 soname,那么默认不开启 soname 版本兼容控制:
set_version("1.0.1") -> libfoo.so, libfoo.dylib
改进 add_vectorexts 接口
add_vectorexts 接口主要用于添加扩展指令优化选项,目前支持以下几种扩展指令集:
add_vectorexts("mmx")
add_vectorexts("neon")
add_vectorexts("avx", "avx2", "avx512")
add_vectorexts("sse", "sse2", "sse3", "ssse3", "sse4.2")
其中,avx512
, sse4.2
是我们新版本新增的指令配置,另外我们还新增了一个 all
配置项,可以用于尽可能的开启所有扩展指令优化。
add_vectorexts("all")
新增 set_encodings 接口
这个新接口主要用于设置源文件、目标执行文件的编码。
默认情况下,我们仅仅指定编码,是会同时对源文件,目标文件生效。
-- for all source/target encodings
set_encodings("utf-8") -- msvc: /utf-8
它等价于:
set_encodings("source:utf-8", "target:utf-8")
并且,目前仅仅支持设置成 utf-8 编码,将来会不断扩展。
如果,我们仅仅想单独设置源文件编码,或者目标文件编码,也是可以的。
设置源文件编码
通常指的是编译的代码源文件的编码,我们可以这么设置。
-- gcc/clang: -finput-charset=UTF-8, msvc: -source-charset=utf-8
set_encodings("source:utf-8")
设置目标文件编码
它通常指的是目标可执行文件的运行输出编码。
-- gcc/clang: -fexec-charset=UTF-8, msvc: -target-charset=utf-8
set_encodings("target:utf-8")
新增 add_forceincludes 接口
我们还新增了 add_forceincludes
接口,用于在配置文件中直接强制添加 includes
头文件。
add_forceincludes("config.h")
它的效果类似于 #include <config.h>
,但是不需要在源码中显式添加它了。
另外,它的搜索路径也是需要通过 add_includedirs
来控制,而不是直接配置文件路径。
add_forceincludes("config.h")
add_includedirs("src")
默认 add_forceincludes
匹配 c/c++/objc。如果仅仅只想匹配 c++ 可以这么配置:
add_forceincludes("config.h", {sourcekinds = "cxx"})
如果想同时匹配多个源文件类型,也是可以的:
add_forceincludes("config.h", {sourcekinds = {"cxx", "mxx"}})
对于 gcc,它会设置 -include config.h
标志,对于 msvc,它会设置 -FI config.h
标志。
新增 add_extrafiles 接口
在之前的版本中,如果我们要在 vs/vsxmake 工程生成器中添加一些额外的文件到工程列表中去,只能通过 add_headerfiles
来添加,但是这有一点 Hack。
因此,我们新增了 add_extrafiles
接口,专门用于配置一些额外的文件到工程中,这样,用户也可以快速点击编辑它们。
这些被添加文件不是代码文件,不会参与编译,也不会被安装,仅仅只是能够让用户方便的在生成的工程 IDE 中,快速编辑访问它们。
将来,我们也可能用此接口做更多其他的事情。
add_extrafiles("assets/other.txt")
sdasstm8 汇编器支持
@lanjackg2003 帮忙贡献了 sdcc/sdasstm8 汇编器的支持,非常感谢。
相关 patch, #4071
改进 Rust 交叉编译支持
新版本中,我们还对 Rust 项目构建做了改进,新增了交叉编译支持,包括对依赖包的交叉编译。
set_arch("aarch64-unknown-none")
add_rules("mode.release", "mode.debug")
add_requires("cargo::test", {configs = {
std = false,
main = false,
cargo_toml = path.join(os.projectdir(), "Cargo.toml")}})
target("test")
set_kind("binary")
add_files("src/main.rs")
add_packages("cargo::test")
例如上面的项目配置,我们通过 set_arch("aarch64-unknown-none")
全局修改编译架构,就能对依赖包,以及自身项目进行交叉编译。
如果没有配置 set_arch
,我们也可以通过命令 xmake f -a aarch64-unknown-none; xmake
来动态切换编译架构。
当然,别忘了先得执行 rustup target add aarch64-unknown-none
安装对应的 target 才行。
更多上下文,见:#4049
更新日志
新特性
- #4002: 增加 soname 支持
- #1613: 为 add_vectorexts 增加 avx512 和 sse4.2 支持
- #2471: 添加 set_encodings API 去设置源文件和目标文件的编码
- #4071: 支持 sdcc 的 stm8 汇编器
- #4101: 为 c/c++ 添加 force includes
- #2384: 为 vs/vsxmake 生成器添加 add_extrafiles 接口
改进
- #3960: 改进 msys2/crt64 支持
- #4032: 移除一些非常老的废弃接口
- 改进 tools.msbuild 升级 vcproj 文件
- 支持 add_requires(“xmake::xxx”) 包
- #4049: 改进 Rust 支持交叉编译
- 改进 clang 下 c++ modules 支持
Bugs 修复
- 修复 macOS/Linux 上子子进程无法快速退出问题