This is a mirror page, please see the original page:

https://xmake.io/#/zh-cn/guide/faq

怎样获取更多参数选项信息?

获取主菜单的帮助信息,里面有所有action和plugin的列表描述。

$ xmake [-h|--help]

获取配置菜单的帮助信息,里面有所有配置选项的描述信息,以及支持平台、架构列表。

$ xmake f [-h|--help]

获取action和plugin命令菜单的帮助信息,里面有所有内置命令和插件任务的参数使用信息。

$ xmake [action|plugin] [-h|--help]

例如,获取run命令的参数信息:

$ xmake run --help

怎样实现静默构建,不输出任何信息?

$ xmake [-q|--quiet]

如果xmake运行失败了怎么办?

可以先尝试清除下配置,重新构建下:

$ xmake f -c
$ xmake

如果还是失败了,请加上 -v 或者 --verbose 选项重新执行xmake后,获取更加详细的输出信息

例如:

$ xmake [-v|--verbose] 

并且可以加上 -D 选项获取出错时的xmake的调试栈信息和其他更详细的诊断信息, 然后你可以提交这些信息到issues.

$ xmake -v -D

怎样看实时编译警告信息?

为了避免刷屏,在构建时候,默认是不实时输出警告信息的,如果想要看的话可以加上-w选项启用编译警告输出就行了。

$ xmake [-w|--warning] 

怎样基于源码自动生成xmake.lua?

如果你想临时写一两个测试代码、或者手上有一些移植过来的零散源码想要快速编译运行,可以不用专门xmake.lua,直接运行:

$ xmake

xmake会自动扫描分析当前的源码目录,识别程序结构和类型,生成一个xmake.lua,并且会尝试直接构建它。

如果编译成功,可以直接运行:

$ xmake run

当然,如果仅仅只是想要生成xmake.lua,默认不去构建,可以执行:

$ xmake f -y

更多相关介绍,请参考文章:xmake新增智能代码扫描编译模式,无需手写任何make文件

为什么xmake.lua会被执行多遍?

xmake.lua里面分描述域和脚本域,在描述域里面会对各种配置域进行分阶段多次解析,有可能会执行多遍,因此不要在描述域写复杂的脚本。

如果要写各种复杂脚本,请在脚本域内进行配置,target/on_load的脚本域里面同样可以灵活配置各种target相关设置,并且提供更强大的lua脚本模块支持。

更多细节见:描述语法说明