blob: c48695e251967a235bbb8dc0c482e8f8f1fe21de (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
## 怎样获取更多参数选项信息？
获取主菜单的帮助信息，里面有所有action和plugin的列表描述。
```bash
$ xmake [-h|--help]
```
获取配置菜单的帮助信息，里面有所有配置选项的描述信息，以及支持平台、架构列表。
```bash
$ xmake f [-h|--help]
```
获取action和plugin命令菜单的帮助信息，里面有所有内置命令和插件任务的参数使用信息。
```bash
$ xmake [action|plugin] [-h|--help]
```
例如，获取`run`命令的参数信息:
```bash
$ xmake run --help
```
## 怎样实现静默构建，不输出任何信息？
```bash
$ xmake [-q|--quiet]
```
## 如果xmake运行失败了怎么办？
可以先尝试清除下配置，重新构建下：
```bash
$ xmake f -c
$ xmake
```
如果还是失败了，请加上 `-v` 或者 `--verbose` 选项重新执行xmake后，获取更加详细的输出信息
例如：
```hash
$ xmake [-v|--verbose]
```
并且可以加上 `--backtrace` 选项获取出错时的xmake的调试栈信息, 然后你可以提交这些信息到[issues](https://github.com/xmake-io/xmake/issues).
```bash
$ xmake -v --backtrace
```
## 怎样看实时编译警告信息?
为了避免刷屏，在构建时候，默认是不实时输出警告信息的，如果想要看的话可以加上`-w`选项启用编译警告输出就行了。
```bash
$ xmake [-w|--warning]
```
## 怎样基于源码自动生成xmake.lua？
如果你想临时写一两个测试代码、或者手上有一些移植过来的零散源码想要快速编译运行，可以不用专门xmake.lua，直接运行：
```bash
$ xmake
```
xmake会自动扫描分析当前的源码目录，识别程序结构和类型，生成一个xmake.lua，并且会尝试直接构建它。
如果编译成功，可以直接运行：
```bash
$ xmake run
```
当然，如果仅仅只是想要生成xmake.lua，默认不去构建，可以执行：
```bash
$ xmake f -y
```
更多相关介绍，请参考文章：[xmake新增智能代码扫描编译模式，无需手写任何make文件](https://tboox.org/cn/2017/01/07/build-without-makefile/)
## 为什么xmake.lua会被执行多遍？
xmake.lua里面分描述域和脚本域，在描述域里面会对各种配置域进行分阶段多次解析，有可能会执行多遍，因此不要在描述域写复杂的脚本。
如果要写各种复杂脚本，请在脚本域内进行配置，`target/on_load`的脚本域里面同样可以灵活配置各种target相关设置，并且提供更强大的lua脚本模块支持。
更多细节见：[描述语法说明](/zh-cn/guide/syntax_description)
|
