Running & Writing Xmake's Unit Tests

This skill is about the xmake project's own internal test suite — useful when you are fixing a bug in xmake itself, adding a new API, or verifying a backport. For testing your own C/C++ project, see xmake-tests.

The suite lives under tests/ in the xmake source tree. Each subdirectory is a self-contained test (usually a mini project) driven by a runner.lua or a test.lua.

Prerequisites

You need a checkout of xmake and the source-level env loaded:

git clone --recursive https://github.com/xmake-io/xmake.git
cd xmake
./configure && make -j            # or on Windows: cd core && xmake
source scripts/srcenv.profile     # so `xmake` points at the local checkout
xmake l xmake.programdir          # verify: should end in .../xmake/xmake

See xmake-dev for the full build-from-source flow.