Godot Size Benchmarks
This repository contains a program that compiles Godot export templates with various settings to decrease file size.
Results
The results below were generated on Fedora 30 with GCC 9.1.1 from the Godot 3.1.1 stable source code. All binaries had their debug symbols stripped.
fullbuilds have all modules enabled.microbuilds have commonly-used modules enabled (such as mbedTLS or Theora/WebM); lesser-used modules are disabled.picobuilds have all modules disabled and are optimized for size instead of speed.- Builds with a
_2dsuffix have 3D support disabled.
Check the build script for the list of SCons flags used by each build type.
| Platform | Build type | Size (uncompressed) | Size (compressed) |
|---|---|---|---|
| Android | full |
11.8 MB | 11.8 MB |
| Android | full_2d |
9.5 MB | 9.5 MB |
| Android | micro |
9.8 MB | 9.8 MB |
| Android | micro_2d |
8.5 MB | 8.5 MB |
| Android | pico |
8.1 MB | 8.1 MB |
| Android | pico_2d |
7.1 MB | 7.1 MB |
| HTML5 | full |
13.0 MB | 4.0 MB |
| HTML5 | full_2d |
11.3 MB | 3.4 MB |
| HTML5 | micro |
11.5 MB | 3.4 MB |
| HTML5 | micro_2d |
10.2 MB | 3.1 MB |
| HTML5 | pico |
10.9 MB | 3.2 MB |
| HTML5 | pico_2d |
9.7 MB | 2.9 MB |
| Linux | full |
30.9 MB | 12.0 MB |
| Linux | full_2d |
25.9 MB | 10.0 MB |
| Linux | micro |
27.3 MB | 10.4 MB |
| Linux | micro_2d |
23.4 MB | 9.0 MB |
| Linux | pico |
15.7 MB | 6.0 MB |
| Linux | pico_2d |
13.5 MB | 5.1 MB |
| Windows | full |
26.7 MB | 10.2 MB |
| Windows | full_2d |
22.5 MB | 8.6 MB |
| Windows | micro |
23.7 MB | 9.0 MB |
| Windows | micro_2d |
20.2 MB | 7.7 MB |
| Windows | pico |
(build failing) | N/A |
| Windows | pico_2d |
(build failing) | N/A |
Platform-specific notes
- Android: Android APK sizes were measured after building for
armv7only, which means only one architecture was included in the APK. Android APKs are already compressed on creation, hence the compressed size being identical to the uncompressed size. - HTML5: Displayed file sizes only include the main WebAssembly blob. The
accompanying JavaScript file's size (330 KB uncompressed, 75 KB gzipped)
remains mostly constant. Compressed sizes were measured by compressing the
WebAssembly blob with
gzip -6, which is the compression level used on most Web servers (after enabling compression for.wasmfiles). - Linux: Binaries were compiled with link-time optimization enabled.
Compressed sizes were measured by creating ZIP archives using
7z a -mx9 <file>.zip <file>. - Windows: Binaries were compiled using MinGW with link-time optimization
enabled. Compressed sizes were measured by creating ZIP archives using
7z a -mx9 <file>.zip <file>.
Running the benchmark locally
Note: The benchmark runner currently only supports Linux.
Pre-requisites
- Nim 0.20.0 or later (can be installed via choosenim).
- Godot build dependencies set up for Android, HTML5, Linux and Windows (MinGW).
- This Git repository (with submodules initialized).
Running
git clone --recursive https://github.com/Calinou/godot-size-benchmarks.git
cd godot-size-benchmarks/
nimble runWait for the script to build all binaries; they will be available in the
godot/bin/ directory.
Resources
- Optimizing a build for size in the Godot documentation.
- Multiple APK support in Google Play to publish one APK per CPU architecture, greatly reducing the file size.
License
Copyright © 2019 Hugo Locurcio and contributors
Unless otherwise specified, files in this repository are licensed under the MIT license; see LICENSE.md for more information.