xmake-rules

Xmake Rules

Rules are reusable bundles of build logic. You apply them with add_rules(...) at project or target scope, or define your own with rule(...).

Common built-in rules

Build modes (at project scope):

add_rules("mode.debug", "mode.release", "mode.releasedbg", "mode.minsizerel")

This enables xmake f -m debug|release|... and sets the corresponding flags.

Target-level built-ins:

target("app")
    add_rules("c++.unity_build", {batchsize = 8})   -- unity builds
    add_rules("c.unity_build")
    add_rules("win.sdk.application")                -- Windows GUI entry
    add_rules("qt.widgetapp")                       -- Qt widgets app
    add_rules("xcode.application")                  -- iOS/macOS app bundle
    add_rules("plugin.compile_commands.autoupdate", {outputdir = "."})

plugin.compile_commands.autoupdate automatically regenerates compile_commands.json on every build — great for clangd/LSP.

File-transform rules

These attach to individual files through add_files(..., {rules = ...}):

-- embed a binary file as a c array (foo.bin -> foo.bin.h)
add_files("res/foo.bin", {rules = "utils.bin2c"})

-- embed it as an object file instead, no header generated
add_files("res/foo.bin", {rules = "utils.bin2obj"})

-- patch a source file while building, without touching the file on disk
add_files("src/foo.c", {rules = "utils.replace",
                        replaces = {{"RDKCONST%);", "VDKREG);"}}})
add_files("src/foo.c", {rules = "utils.replace",
                        replaces = {{"RDKCONST);", "VDKREG);"}}, replace_plain = true})
add_files("src/foo.c", {rules = "utils.replace", replaces = function (content)
    return (content:gsub("old", "new"))
end})

The generated header holds only the byte list, and the rule adds its directory to the target's includedirs itself, so the consumer is:

static const unsigned char g_foo[] = {
#include "foo.bin.h"
};

utils.replace (v3.0.9+) is the clean way to carry a small vendor patch: the transform runs in the build directory, the repository stays unmodified. utils.bin2c / utils.bin2obj (v3.1.0 gained lua-file transforms and ppc/mips support) embed resources without a generator step.