This repository contains few CI workflows to generate linux template, editor and editor with mono builds with and without support for address, undefined and leak sanitizer and also with GCC and LLVM.
Ready to use binaries are in actions or releases tab.
Provided binaries are from the latest commit of each Godot branch - 3.x and master
What is this?
This are normal Godot builds compiled with Address, Leak, Undefined, Thread or Memory sanitizers support.
- Leak sanitizer - at the end prints info about leaked memory
- Undefined sanitizer - during run prints info about undefined C/C++ behaviour like dereferencing null pointer
- Address sanitizer - crashes entire app when critical event happens like e.g. usage after free or array overflow and prints exact place when memory was allocated, freed etc.
- Thread sanitizer - finds bugs caused by wrong operating of memory from multiple threads
- Memory sanitizer - checks for usage of undefined variables
Additionally there is also produced minimal build which is fast to compile, and takes a lot of less space on disk(needed to test if after disabling a lot of modules, still works fine)
Why I may need this?
Sometimes game/app crash, even if looks that code looks fine.
It is possible that engine doesn't work properly, so with this binaries, you can get backtrace of crash which will help to find similar issues in which you may find solution to your problems or you may create bug report which with such detailed backtrace may be more valuable.
Why Godot don't provide such binaries?
Mostly because they are heavy, slow and used by only a few people.
This files weight much more than normal Godot binaries (100MB vs 1,5 GB or more), because contains debug symbols and many functions to provide additional info to user.
Also usually they works ~5/10 times slower, so they should be only used to debug problems.
Requirements
libasan5for all binaries with sanitizers, on Ubuntu this should be installed bysudo apt install libasan5mono-complete6.12 only if using mono version - can be downloaded from https://www.mono-project.com/download/stable/
How to use them?
This are normal Godot binaries, so you can use them exactly as you use Godot.
Why only Linux binaries?
Compiling binaries on Linux is really simple, only require to add specific compile commands. This binaries can be easily run in CI etc.
Windows binaries probably require to use Visual Studio. Also binaries with address sanitizer don't work under Wine, so I can't test them.
Mac is Mac, so it is possible to generate such binaries, but probably Apple require some signing, so I don't even have possibility to test if it works.