This repository contains toolchains usable for crosscompiling with CMake. They're tailored for and mainly used by Magnum but should work for other projects as well.
Assuming a CMake project, point CMAKE_TOOLCHAIN_FILE to one of the toolchain
files during the initial CMake invocation. While relative paths may work in
certain cases, it's better to always pass an absolute path. The
CMAKE_TOOLCHAIN_FILE variable is only used by CMake during the initial run,
it's ignored (and thus doesn't even need to be specified) in subsequent runs.
mkdir build-emscripten && cd build-emscripten
cmake .. -DCMAKE_TOOLCHAIN_FILE=path/to/toolchains/generic/Emscripten-wasm.cmake
The toolchain file then sets up other paths (such as pointing
CMAKE_MODULE_PATH to the modules/Platform/ directory) and the process will
result in a configured build directory that can be subsequently used as any
other. See comments in particular toolchain files for platform-specific
details.
This project is maintained as part of Magnum, so it shares the same suppport channels:
- Project homepage — https://magnum.graphics/
- Documentation — https://doc.magnum.graphics/
- GitHub — https://github.com/mosra/toolchains and the #magnum topic
- GitLab — https://gitlab.com/mosra/toolchains
- Gitter community chat — https://gitter.im/mosra/magnum
- E-mail — [email protected]
- Google Groups mailing list — [email protected] (archive)
- Twitter — https://twitter.com/czmosra and the #MagnumEngine hashtag
See also the Magnum Project Contact & Support page for further information.
While Magnum itself and its documentation are licensed under the MIT/Expat license, the toolchains are put into public domain (or UNLICENSE) to free you from any legal obstacles when using these to build your apps. See the COPYING file for details.
