运行目标

Xmake 提供了内置的 xmake run 命令，可以快速的运行被构建的目标程序，而无需手动找到对应的可执行文件来运行。

这会提供许多的便利，并且它还会自动绑定运行需要的环境，确保资源、动态库等都能正常被自动加载。

命令格式

$ xmake run [options] [target] [runargs]

注意

前面的 options 是 xmake run 的参数选项，而后面的 runargs 是特定于 target 目标的可执行参数，可以原样传递进 target 目标程序内部。

运行一个程序

通常我们只需要执行 xmake run 即可运行所有的可执行程序。

$ xmake run
hello world!

运行特定的目标程序

如果要运行指定的目标程序，可以执行：

$ xmake run foo

运行所有程序

如果 target 被配置为 default = false，那么默认是不会运行它的。

target("test")
    set_default(false)
    add_files("src/*.c")

如果想要运行所有目标， 包括这些 default = false 的目标程序，那么可以传递 -a/--all 参数。

$ xmake run -a

传递运行参数

我们还可以传递运行参数给内部的目标程序。

$ xmake run foo --arg1=xxx --arg2=yyy

注意

这个时候，我们不能省略目标名称，必须指定需要运行的目标名，否则会导致参数歧义。

我们也可以通过 target 的 set_runargs 配置接口，来指定传入的运行参数，而不需要每次命令行指定它。

设置运行的工作目录

默认情况下，xmake run 的工作目录是在可执行文件所在的目录，这有助于它能够方便的找到一些资源和动态库，也能做一些路径隔离，避免一些程序生成文件到当前工程根目录下。

如果我们想修改工作目录，我们可以通过 -w workdir 参数来指定。

$ xmake run -w /tmp foo

我们将 foo 程序的运行目录改成了 /tmp/。

另外，我们也可以通过 target 的 set_rundir 配置接口，来指定传入的运行参数，而不需要每次命令行指定它。

调试程序

我们也可以传递 -d 参数，让 xmake run 在运行程序的同时，加载当前系统环境可用的调试器，例如：gdb/lldb。

但前提是，当前程序必须是调试模式编译的，否则会因为缺少必要的符号信息，看不到调用栈、行号等信息，不便于调试。

$ xmake f -m debug
$ xmake

$ xmake run -d hello

Xmake 将会使用调试器去加载程序运行，目前支持：lldb, gdb, windbg, vsjitdebugger, ollydbg 等各种调试器。

[lldb]$target create "build/hello"
Current executable set to 'build/hello' (x86_64).
[lldb]$b main
Breakpoint 1: where = hello`main, address = 0x0000000100000f50
[lldb]$r
Process 7509 launched: '/private/tmp/hello/build/hello' (x86_64)
Process 7509 stopped
* thread #1: tid = 0x435a2, 0x0000000100000f50 hello`main, queue = 'com.apple.main-thread', stop reason = breakpoint 1.1
    frame #0: 0x0000000100000f50 hello`main
hello`main:
->  0x100000f50 <+0>:  pushq  %rbp
    0x100000f51 <+1>:  movq   %rsp, %rbp
    0x100000f54 <+4>:  leaq   0x2b(%rip), %rdi          ; "hello world!"
    0x100000f5b <+11>: callq  0x100000f64               ; symbol stub for: puts
[lldb]$

另外，我们也能够切换使用指定的调试器：

$ xmake f --debugger=gdb
$ xmake run -d hello