A thin, versioned wrapper over the native macOS compiler toolchain (Xcode Command Line Tools' AppleClang, and Homebrew GCC if installed) — not cross-compilation. Its job is reproducibility: pin exactly which compiler/version built a given SAPI binary, rather than "whatever happens to be on PATH."

Usage

./setup.sh # once, after cloning — resolves the active compilers, creates bin/ wrappers

./verify.sh # compiles, links, and runs a trivial hello-world through each wrapped compiler

Then from any SAPI CMake project:

cmake -S . -B build-macos-pinned \

-DCMAKE_TOOLCHAIN_FILE=../SAPIMacOSToolchain/cmake/Toolchain-macOS.cmake

bin/, lib/, include/, VERSION are gitignored and generated by setup.sh — rerun it after an Xcode/Homebrew update to re-pin.

Scope

macOS only, native target only — not part of the cross-compilation story. See LinuxMacOSToolchain, QNXMacOSToolchain, FreeRTOSToolchain for actual cross-compilation targets.