xmake v2.1.9版本发布,增加可视化图形菜单配置

时间:2023-12-12 10:26:38

此版本主要增加xmake f --menu实现用户自定义图形菜单配置,界面风格类似linux的make menuconfig

[图片上传失败…(image-505bc0-1517795319124)]

更多使用说明,请阅读:文档手册

项目源码:Github, Gitee.

新特性

  • 添加del_files()接口去从已添加的文件列表中移除一些文件
  • 添加rule(), add_rules()接口实现自定义构建规则,并且改进add_files("src/*.md", {rule = "markdown"})
  • 添加os.filesize()接口
  • 添加core.ui.xxx等cui组件模块,实现终端可视化界面,用于实现跟用户进行短暂的交互
  • 通过xmake f --menu实现可视化菜单交互配置,简化工程的编译配置
  • 添加set_values接口到option
  • 改进option,支持根据工程中用户自定义的option,自动生成可视化配置菜单
  • 在调用api设置工程配置时以及在配置菜单中添加源文件位置信息

改进

  • 改进交叉工具链配置,通过指定工具别名定向到已知的工具链来支持未知编译工具名配置, 例如: xmake f --cc=gcc@ccmips.exe
  • #151: 改进mingw平台下动态库生成
  • 改进生成makefile插件
  • 改进检测错误提示
  • 改进add_cxflags等flags api的设置,添加force参数,来禁用自动检测和映射,强制设置选项:add_cxflags("-DTEST", {force = true})
  • 改进add_files的flags设置,添加force域,用于设置不带自动检测和映射的原始flags:add_files("src/*.c", {force = {cxflags = "-DTEST"}})
  • 改进搜索工程根目录策略
  • 改进vs环境探测,支持加密文件系统下vs环境的探测
  • 升级luajit到最新2.1.0-beta3
  • 增加对linux/arm, arm64的支持,可以在arm linux上运行xmake
  • 改进vs201x工程生成插件,更好的includedirs设置支持

Bugs修复

  • 修复依赖修改编译和链接问题
  • #151: 修复os.nuldev()在mingw上传入gcc时出现问题
  • #150: 修复windows下ar.exe打包过长obj列表参数,导致失败问题
  • 修复xmake f --cross无法配置问题
  • 修复os.cd到windows根路径问题

新特性介绍

新增del_files接口实现从源文件列表中删除指定文件

通过此接口,可以从前面add_files接口添加的文件列表中,删除指定的文件,例如:

target("test")
add_files("src/*.c")
del_files("src/test.c")

上面的例子,可以从`src`目录下添加除`test.c`以外的所有文件,当然这个也可以通过`add_files(“src/*.c|test.c”)`来达到相同的目的,但是这种方式更加灵活。

例如,我们可以条件判断来控制删除哪些文件,并且此接口也支持[add_files](http://xmake.io/#/zh/manual?id=targetadd_files)的匹配模式,过滤模式,进行批量移除。

target("test")
add_files("src/**.c")
del_files("src/test*.c")
del_files("src/subdir/*.c|xxx.c")
if is_plat("iphoneos") then
add_files("xxx.m")
end

通过上面的例子,我们可以看出`add_files`和`del_files`是根据调用顺序,进行顺序添加和删除的,并且通过`del_files(“src/subdir/*.c|xxx.c”)`删除一批文件,
并且排除`src/subdir/xxx.c`(就是说,不删除这个文件)。

通过rule()接口实现用户自定义编译规则

在2.1.9版本之后,xmake不仅原生内置支持多种语言文件的构建,而且还可以通过自定义构建规则,让用户自己来实现复杂的未知文件构建。

我们可以通过预先设置规则支持的文件后缀,来扩展其他文件的构建支持:

-- 定义一个markdown文件的构建规则
rule("markdown")
set_extensions(".md", ".markdown")
on_build(function (target, sourcefile)
os.cp(sourcefile, path.join(target:targetdir(), path.basename(sourcefile) .. ".html"))
end) target("test")
set_kind("binary") -- 使test目标支持markdown文件的构建规则
add_rules("markdown") -- 添加markdown文件的构建
add_files("src/*.md")
add_files("src/*.markdown")

我们也可以指定某些零散的其他文件作为markdown规则来处理:

target("test")
-- ...
add_files("src/test/*.md.in", {rule = "markdown"})

通过`add_files(“*.md”, {rule = “markdown”})`方式指定的规则,优先级高于`add_rules(“markdown”)`设置的规则。

我们还可以实现规则的级联构建,例如在构建man规则后,继续调用markdown规则,实现级联构建:

rule("man")
add_imports("core.project.rule")
on_build(function (target, sourcefile)
rule.build("markdown", target, sourcefile)
end)

对于有些文件,需要支持多文件构建生成单一对象的模式,可以通过on_build_all来实现:

rule("man")
on_build_all(function (target, sourcefiles)
-- build some source files
for _, sourcefile in ipairs(sourcefiles) do
-- ...
end
end) target("test")
-- ...
add_files("src/test/*.doc.in", {rule = "man"})

通过xmake f --menu实现可视化菜单配置

之前的版本,使用option可实现命令行菜单选项的用户自定义,当工程配置相当多的情况下,采用这种命令行配置的方式就不是很灵活了。

因此在2.1.9版本中,我们扩展了option,使其原生支持xmake f --menu的图形化配置界面,实现复杂的分级配置,并且支持配置的模糊查找和定位,配置项目更加灵活方便。

我们可以通过set_category设置option的分级路径名set_category("root/submenu/submenu2"),例如:

-- 'boolean' option
option("test1")
set_default(true)
set_showmenu(true)
set_category("root menu/test1") -- 'choice' option with values: "a", "b", "c"
option("test2")
set_default("a")
set_values("a", "b", "c")
set_showmenu(true)
set_category("root menu/test2") -- 'string' option
option("test3")
set_default("xx")
set_showmenu(true)
set_category("root menu/test3/test3") -- 'number' option
option("test4")
set_default(6)
set_showmenu(true)
set_category("root menu/test4")

上述配置最后显示的菜单界面路径结构:

  • root menu
    • test1
    • test2
    • test3
    • test3
    • test4

效果图如下:

[图片上传失败…(image-4d2cb7-1517795319124)]

并且我们还可以通过set_values,提供选项值列表供用户快速选择使用,例如:

option("test")
set_default("b")
set_showmenu(true)
set_values("a", "b", "c")

效果图如下:

[图片上传失败…(image-818f30-1517795319124)]

搜索用户配置

[图片上传失败…(image-ac806e-1517795319124)]

原文出处:http://tboox.org/cn/2018/02/03/update-v2.1.9/