xmake-docs/docs/examples/configuration/custom_toolchain.md

---

outline: deep

Custom Toolchain

We can use toolchain() to define custom toolchains to support special compilers or cross-compilation environments.

For details on custom toolchain configuration, see: Custom Toolchain API.

Basic Example

Build and Run

$ xmake
$ xmake run

Unknown Toolchain

If we need to support a completely unknown compiler toolchain, we need to implement the detection script of the toolchain, as well as the script configuration of all tool sets such as compilation, linking, archiving, etc.