8b6ddfe97a
This tool makes it easy to analyze the composition of Android
applications that use Filament.
- Filament materials are shown in the treemap if `resgen --json` was
used in the build.
- The input path can be a so file, folder, or zip archive (apk or aar).
- If the path is a zip or folder, helps you find the file to analyze.
- The generated web report is a self-contained HTML file.
- Reports the gzipped size of all Filament materials.
For example, from a mac, you can generate a self-contained HTML file by
typing this from the Filament repo root:
./tools/zbloat/zbloat.py ./android/filament-android
open index.html
This tool uses Python, `nm`, and `objdump`.
The `nm` tool works slightly differently between macOS and Linux, so a
`Dockerfile` is provided that installs dependencies inside a Linux
container. This is also convenient if you do not have both versions of
Python on your system.
The easy way to use docker is to invoke the helper bash script. Simply
type `zbloat.sh [args...]` instead of `zbloat.py [args...]`. The first
time you run it, it will be slow but subsequent times will be fast.
Many thanks to Evan Martin for his interactive treemap widget.
1.3 KiB
zbloat
This tool makes it easy to analyze the composition of Android applications that use Filament.
- Filament materials are shown in the treemap if
resgen --jsonwas used in the build. - The input path can be a so file, folder, or zip archive (apk or aar).
- If the path is a zip or folder, interactively finds the file to analyze.
- The generated web report is a self-contained HTML file.
- Reports the gzipped size of all Filament materials.
Note that the executable must be built with debugging information.
For example, from a mac, you can generate a self-contained HTML file by typing this from the Filament repo root:
./tools/zbloat/zbloat.py ./android/filament-android
open index.html
This tool uses Python, nm, and objdump.
Linux, macOS, and Docker
The nm tool works slightly differently between macOS and Linux, so a Dockerfile is
provided that installs dependencies inside a Linux container. This is also convenient if you
do not have both versions of Python on your system.
The easy way to use docker is to invoke the helper bash script. Simply type zbloat.sh [args...]
instead of zbloat.py [args...]. The first time you run it, it will be slow but subsequent times
will be fast.
Many thanks to Evan Martin for his interactive treemap widget.