This is a simple Make build system for Windows.

xbuild only support following operating systems:

• Windows 10 (64 bits) and above. (Currently xbuild only support 64 bits Windows.)

This build system requires Visual Studio 2019 or above

This build system requires Python 3.10 or above

Latest version of Git is required. GitBash should be installed to execute build command and scripts.

Windows Terminal is optional, but it is a good console, recommended.

Use following command to get xbuild:

git clone --recurse-submodules [email protected]:realxye/xbuild.git

Before use xbuild, execute following command in Git Bash to initialize xbuild and generate proper profiles.

cd <xbuild-root-dir>
python xbuild.py

After xbuild get initialized, restart bash or run command to launch xbuild to current bash environment:

source xbuild.bashrc

When system environment is changed, execute following command to update xbuild profile.

cdx
source xbuild.bashrc

A project includes project Makefile and one or more modules.

    PROJECT ROOT
    |---- Makefile
    |---- Module1
            |---- ...
    |---- Module2
            |---- ...
    |---- Module3
            |---- ...
    |---- Tests
            |---- TestModule1
            |---- TestModule2

To create a project, use following command:

xbuild-create project <PROJECT-NAME> [--force]

The --force option will force to create project even the folder or file with the same name already exist.

Check xbuild/samples for more information

Every single module must follow a specific folder structure:

    MODULE ROOT
    |---- Makefile
    |---- src/
    |---- [include]/

To create a module for existing project, execute following command at project root directory:

xbuild-create module <MODULE-NAME>

Check xbuild/samples for more information

To build target project, run following command in project's root directory:

xmake config=<release|debug> arch=<x86|x64|arm|arm64> [target=PATH-TO-SUB-MODULE]

To clean project, run following command:

xbuild clean config=<release|debug> arch=<x86|x64|arm|arm64> [target=PATH-TO-SUB-MODULE]

TBD