269b115d9c
Upon investigating the extremely slow MSVC build times in #80513, I noticed
that while Godot policy is to never use exceptions, we weren't enforcing it
with compiler flags, and thus still included exception handling code and
stack unwinding.
This is wasteful on multiple aspects:
- Binary size: Around 20% binary size reduction with exceptions disabled
for both MSVC and GCC binaries.
- Compile time:
* More than 50% build time reduction with MSVC.
* 10% to 25% build time reduction with GCC + LTO.
- Performance: Possibly, needs to be benchmarked.
Since users may want to re-enable exceptions in their own thirdparty code
or the libraries they compile with Godot, this behavior can be toggled with
the `disable_exceptions` SCons option, which defaults to true.
(cherry picked from commit
|
||
|---|---|---|
| .. | ||
| api | ||
| doc_classes | ||
| export | ||
| js | ||
| .eslintrc.engine.js | ||
| .eslintrc.html.js | ||
| .eslintrc.js | ||
| .eslintrc.libs.js | ||
| README.md | ||
| SCsub | ||
| audio_driver_web.cpp | ||
| audio_driver_web.h | ||
| detect.py | ||
| display_server_web.cpp | ||
| display_server_web.h | ||
| dom_keys.inc | ||
| emscripten_helpers.py | ||
| godot_audio.h | ||
| godot_js.h | ||
| godot_webgl2.h | ||
| http_client_web.cpp | ||
| http_client_web.h | ||
| javascript_bridge_singleton.cpp | ||
| os_web.cpp | ||
| os_web.h | ||
| package-lock.json | ||
| package.json | ||
| platform_config.h | ||
| serve.py | ||
| web_main.cpp | ||
| web_runtime.cpp | ||
README.md
Web platform port
This folder contains the C++ and JavaScript code for the Web platform port, compiled using Emscripten.
It also contains a ESLint linting setup (see package.json).
See also misc/dist/html folder for additional files used by
this platform such as the html shell (web page).
Documentation
- Compiling for the Web
- Instructions on building this platform port from source.
- Exporting for the Web
- Instructions on using the compiled export templates to export a project.
Artwork license
logo.png and run_icon.png are licensed under
Creative Commons Attribution 3.0 Unported
per the HTML5 logo usage guidelines.
