Building JitCat

JitCat uses the CMake build system on all supported platforms.
Using CMake, you can generate a makefile or project files for IDEs like Visual Studio.
I recommend using the CMake GUI.


Enabling/Disabling building JitCat components

There are several CMake options for enabling/disabling building parts of JitCat. These are all enabled by default.

If you just need the library and not any of the tools/tests/examples, only enable BUILD_JITCAT_LIB and disable the rest.

Enable LLVM support

JitCat has an optional dependency on LLVM.
This allows JitCat to build expressions to native code instead of executing expressions through the interpreter and improves performance of non-trivial expressions by a lot.
See this document for information on how to build LLVM for use with JitCat.
To enable the use of LLVM with JitCat, set the following variables when generating build files with CMake:
LLVM_BUILD_DIR <- the directory where LLVM was built, this is usually the output directory set with CMake when building LLVM.
LLVM_INCLUDES <- the directory where LLVM include files are located, this is usually the “include” folder inside a LLVM checkout.

LLVM_ENABLED must also be defined in your program before including any JitCat headers.

You will also need to link to the LLVM libraries in addition to the JitCat library.
See the CMakeLists.txt file for which LLVM libraries to link against. The order in which those libraries are linked is critical.

Other CMake options

When generating Visual Studio project files there is an additional option that enables an experimental feature in Visual Studio that disables warnings from headers external to JitCat:
It is recommeded to enable this when building with LLVM support because the LLVM headers currently generate a lot of warnings in MSVC.