xmake(1) General Commands Manual xmake(1)

xmake - cross-platform build utility based on Lua

xmake [task] [options] [target]

xmake is a lightweight cross-platform build utility based on Lua. It uses xmake.lua to maintain project builds. Compared with makefile/CMakeLists.txt, the configuration syntax is more concise and intuitive. It is very friendly to novices and can quickly get started in a short time. Let users focus more on actual project development.

Build targets if no given tasks.

Uninstall the project binary files.

Package target.

Run the project target.

Configure the global options for xmake.

Package and install the target binary files.

Remove all binary and temporary files.

Create a new project.

Install and update required packages.

Update and uninstall the xmake program.

Configure the project.

Manage plugins of xmake.

Run the given macro.

Generate the doxygen document.

Run the lua script.

Manage package repositories.

Start service for remote or distributed compilation and etc. (Experimental, still in development)

Generate the project file.

Show the given project information.

Quiet operation.

Input yes by default if need user confirm.

Input the given result if need user confirm.
- yes
- no
- def

Print lots of verbose information for users.

Allow one to run xmake as root.

Print lots of diagnosis information (backtrace, check info ..) only for developers. And we can append -v to get more whole information.
e.g. $ xmake -vD

Print the version number and exit.

Print this help message and exit.

Read a given xmake.lua file.

Change to the given project directory. Search priority:
1. The Given Command Argument
2. The Environment Variable: XMAKE_PROJECT_DIR
3. The Current Directory

Build target. This is default building mode and optional.

Rebuild the target.

Build all targets.

Dry run to build target.

Specifies the number of jobs to build simultaneously. (default: 6)

Enable the warnings output.

Build the given source files.

e.g.

  - xmake --files=src/main.c
  - xmake --files='src/*.c' [target]
  - xmake --files='src/**c|excluded_file.c'
  - xmake --files='src/main.c:src/test.c'

The target name. It will build all default targets if this parameter is not specified.

xmake is written by ruki.

This manual page was written by Yangfl for the Debian Project (and may be used by others).