SCons‐simplified
SCons is a build system which is used by Godot, and as such, is used by all platform implementations. SCons scripts are small python scripts that serve the same general purpose that a makefile traditionally would, making them a very friendly option for doing makefile-like things in a familiar syntax. It uses an environment variable to configure the wheres, whats, whys, and hows of the compiler Godot will be using.
CC is the directory of the C compiler.
CXX is the directory of the C++ compiler.
LD is the directory of the linker.
os.environ.get(variable_name, expected_path) can be used to attempt to fill in path variables with their default value, even if the environment variable ins't exported properly.
These are functions that are defined in the platform's detect.py file.
can_build keeps track of whether the engine can be built in a variable, and tells you all the things that are wrong before it returns false.
get_flags returns an array of tuples for which SCons env variables should be set by default. We use it to
- disable the editor by default
- disable modules that are completely incompatible at the moment
- set which builtin libs can be replaced with their Portlibs counterparts
get_opts defines new options you can pass into SCons if there's something you want to be able to change, like generating debug symbols.
