Analyze and reduce ExecuTorch binary size. Use when investigating binary size, running size tests, or optimizing the runtime for size-constrained deployments.
main branch of executorchAsk the user where the executorch repo is.
git checkout main && git pull
conda activate executorch
bash test/build_size_test.sh
strip -o /tmp/size_test_stripped cmake-out/test/size_test
strip -o /tmp/size_test_all_ops_stripped cmake-out/test/size_test_all_ops
ls -la /tmp/size_test_stripped /tmp/size_test_all_ops_stripped
Produces two binaries:
cmake-out/test/size_test — ExecuTorch runtime without operator implementationscmake-out/test/size_test_all_ops — ExecuTorch runtime with portable opsbloaty cmake-out/test/size_test -d symbols -n 30 # by symbol
bloaty cmake-out/test/size_test -d sections # by ELF section
bloaty <after> -- <before> # diff two builds
nm -S <binary> | sort -k2 -rn | head -30 # symbol sizes
strings <binary> | less # string literals in .rodata
Note: bloaty -d compileunits requires debug info (-g). The Release build does not include it.
Set by test/build_size_test.sh:
CMAKE_BUILD_TYPE=ReleaseEXECUTORCH_OPTIMIZE_SIZE=ON — enables -Os, -fno-exceptions, -fno-rtti, unwind table suppressionCXXFLAGS="-fno-exceptions -fno-rtti -Wall -Werror"executorch-ubuntu-22.04-gcc9-nopytorch) and Clang 12 — avoid compiler-specific flags or pragmas without version guardsbuild_size_test.sh for size reductions.text: look for large functions, template bloat, duplicate instantiations.rodata: verbose error messages, format strings, embedded file paths (__FILE__).eh_frame: should already be suppressed when EXECUTORCH_OPTIMIZE_SIZE=ONnm -S <binary> | grep GLOBAL__sub_I): use constexpr constructors to constant-initialize static arraysET_LOG_ENABLED=0 in Release eliminates format strings; ensure it propagates to consumers via PUBLIC compile definitions on cmake targetsET_LOG_ENABLED set in library but not in consumer)git checkout -b binary-size-<N>binary-size-<N>.md:| Binary | This change (N vs N-1) | Cumulative (N vs main) |
|---|---|---|
size_test (stripped) | -X | -Y |
size_test_all_ops (stripped) | -X | -Y |
.github/workflows/pull.yml if sizes decrease