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
windows 的长路径限制一直是一个大问题,嵌套层级太深的工程,在读写文件的时候,都有可能失败,这会影响 xmake 的可用性和体验。
尽管,xmake 已经提供各种措施也避免这个问题,但是偶尔还是会受到一些限制。而在这个版本中,我们改进了安装器,提供一个安装选项,让用户选择性开启长路径支持。
这需要管理员权限,因为它需要写注册表。
WriteRegDWORD ${HKLM} "SYSTEM\CurrentControlSet\Control\FileSystem" "LongPathsEnabled" 1
用户可以自己决定,是否需要开启它。
感谢 @A2va 的贡献。
新增 OpenSUSE 的 zypper 包管理器支持,可以直接通过 zypper 自动下载安装,并集成它提供的包。
感谢 @iphelf 的贡献。
add_requires("zypper::libsfml2 2.5")
一些第三方包,没有使用 cmake 维护,仅仅提供了 vcproj 的工程文件,如果我们把它做成包,需要使用 tools.msbuild
模块去编译安装它。
但是 vcproj 的 vs 版本如果很老,就需要升级它,否则编译会失败。
因此我们改进了 tools.msbuild 模块,提供自动升级 vcproj 的功能,只需要指定下需要升级的 vcproj/sln 文件即可。
package("test")
on_install(function (package)
import("package.tools.msbuild").build(package, configs, {upgrade={"wolfssl64.sln", "wolfssl.vcxproj"}})
end)
我们改进了对 protobuf 的支持,可以同时支持上 grpc_cpp_plugin。
add_rules("mode.debug", "mode.release")
add_requires("protobuf-cpp")
add_requires("grpc", {system = false})
target("test")
set_kind("binary")
set_languages("c++17")
add_packages("protobuf-cpp")
add_packages("grpc")
add_rules("protobuf.cpp")
add_files("src/*.cpp")
add_files("src/test.proto", {proto_rootdir = "src", proto_grpc_cpp_plugin = true})
add_files("src/subdir/test2.proto", {proto_rootdir = "src"})
完整例子见:protobuf_grpc_cpp_plugin
通常 add_links 需要配合 add_linkdirs 使用,才能让链接器找到指定目录下的库文件。
但是有时候配置不对,或者不同路径下库重名,就容易找错库文件。而现在 add_links 可以支持直接设置库文件路径,避免隐式搜索。
也可以用于显式指定链接 so/a 库。
下面的几种写法都是支持的:
add_links("foo")
add_links("libfoo.a")
add_links("libfoo.so")
add_links("/tmp/libfoo.a")
add_links("/tmp/libfoo.so")
add_links("foo.lib")
之前的版本,我们如果使用 set_pcxxheader
设置 c++ 头文件预编译,会同时影响 objc 代码。
因此如果 C++/ObjC++ 代码混合编译,用了预编译头,就会遇到编译问题。
Objective-C was disabled in PCH file but is currently enabled
这是因为,预编译头的编译,也是需要指定语言的 -x c++-header
, -x objective-c++-header
,pch 文件不能混用。
因此,我们新增了 set_pmheader
和 set_pmxxheader
接口,单独设置 objc/objc++ 的预编译头文件,跟 C/C++ 预编译头互不冲突。
但用法完全一样。
target("test")
set_pmxxheader("header.h")
完整例子见:Objc Precompiled Header Example
上个版本,我们初步支持了 Conan 2.0,但是还遇到了一些细节问题,这个版本我们持续做了改进,比如改进对 vs_runtime 设置问题。
最近 Lua 已经发布了 5.4.6 版本,我们对 xmake 中内置的 Lua 运行时也做了升级,跟上游保持同步。
https://tboox.org/cn/2023/07/11/xmake-update-v2.8.1/