Relintai/pandemonium_engine_docs
1
0
Fork 0
mirror of https://github.com/Relintai/pandemonium_engine_docs.git synced 2025-01-06 15:00:03 +01:00
Code Issues Packages Projects Releases Wiki Activity

Cleaned up the Optimizing a build for size section.

Browse Source
This commit is contained in:
Relintai 2023-04-07 00:07:00 +02:00
parent a0d8d885d9
commit c577f4c8b7
1 changed files with 10 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
development/compiling/optimizing_for_size.md
View File

@ -1,11 +1,8 @@
# Optimizing a build for size
Optimizing a build for size ## Rationale
===========================
Rationale
---------
Sometimes, it is desired to optimize a build for size rather than speed. Sometimes, it is desired to optimize a build for size rather than speed.
This means not compiling unused functions from the engine, as well as using This means not compiling unused functions from the engine, as well as using
@ -19,8 +16,7 @@ on compiling Godot for each platform.
The options below are listed from the most important (greatest size savings) The options below are listed from the most important (greatest size savings)
to the least important (lowest size savings). to the least important (lowest size savings).
Stripping binaries ## Stripping binaries
------------------
- **Space savings:** Very high - **Space savings:** Very high
- **Difficulty:** Easy - **Difficulty:** Easy
@ -49,8 +45,7 @@ Note:
and platforms such as Android and HTML5. Instead, pass `debug_symbols=no` and platforms such as Android and HTML5. Instead, pass `debug_symbols=no`
on the SCons command line when compiling. on the SCons command line when compiling.
Optimizing for size instead of speed ## Optimizing for size instead of speed
------------------------------------
- **Space savings:** High - **Space savings:** High
- **Difficulty:** Easy - **Difficulty:** Easy
@ -65,8 +60,7 @@ To enable this, set the `optimize` flag to `size`:
Some platforms such as WebAssembly already use this mode by default. Some platforms such as WebAssembly already use this mode by default.
Compiling with link-time optimization ## Compiling with link-time optimization
-------------------------------------
- **Space savings:** High - **Space savings:** High
- **Difficulty:** Easy - **Difficulty:** Easy
@ -89,8 +83,7 @@ so it should be used only for release builds:
- When compiling the `3.x` branch, you need to have at least 6 GB of RAM - When compiling the `3.x` branch, you need to have at least 6 GB of RAM
available for successful linking with LTO enabled. available for successful linking with LTO enabled.
Disabling 3D ## Disabling 3D
------------
- **Space savings:** Moderate - **Space savings:** Moderate
- **Difficulty:** Easy - **Difficulty:** Easy
@ -106,8 +99,7 @@ Tools must be disabled in order to use this flag, as the editor is not designed
to operate without 3D support. Without it, the binary size can be reduced to operate without 3D support. Without it, the binary size can be reduced
by about 15%. by about 15%.
Disabling advanced GUI objects ## Disabling advanced GUI objects
------------------------------
- **Space savings:** Moderate - **Space savings:** Moderate
- **Difficulty:** Easy - **Difficulty:** Easy
@ -145,8 +137,7 @@ This is everything that will be disabled:
- GraphNode - GraphNode
- GraphEdit - GraphEdit
Disabling unwanted modules ## Disabling unwanted modules
--------------------------
- **Space savings:** Very low to moderate depending on modules - **Space savings:** Very low to moderate depending on modules
- **Difficulty:** Medium to hard depending on modules - **Difficulty:** Medium to hard depending on modules
@ -213,7 +204,4 @@ following:
module_xatlas_unwrap_enabled = "no" module_xatlas_unwrap_enabled = "no"
``` ```
See also: See also: `doc_overriding_build_options`.
`doc_overriding_build_options`.