Filament 16 KB page-size fix: upgrade to 1.53.0

Artifact com.google.android.filament:filament-android · measured 2026-10-01 · all libraries

fixed

Filament versions up to and including 1.52.0 that we measured ship 4 KB-aligned native libraries (offending for Google Play's 16 KB page-size requirement). The first measured aligned stable version is 1.53.0; the newest measured, 1.77.1, is aligned.

Caveats

Sampled, not exhaustive: 41 of 187 published versions were measured with native code; unmeasured versions in between are unknown.

Measured evidence

	Version	Library file	p_align	File date	Source
Last offending	`1.52.0`	`jni/arm64-v8a/libfilament-jni.so`	4 KB (2^12)	Fri, 24 May 2024 19:29:40 GMT	artifact
First aligned	`1.53.0`	`jni/arm64-v8a/libfilament-jni.so`	16 KB (2^14)	Tue, 18 Jun 2024 16:32:05 GMT	artifact

p_align is the smallest PT_LOAD segment alignment of the ELF. 16 KB-compatible needs at least 16384 (2^14). Method: min PT_LOAD p_align of arm64-v8a/x86_64 .so inside the published AAR/JAR; aligned = >=16384 for every lib. Dates are repository file times, not official release dates.

Offending versions measured (26)

1.4.4, 1.4.5, 1.5.0, 1.5.1, 1.5.2, 1.6.0, 1.7.0, 1.8.0, 1.8.1, 1.9.7, 1.9.15, 1.9.24, 1.10.7, 1.12.5, 1.14.0, 1.17.0, 1.20.5, 1.23.0, 1.25.5, 1.28.2, 1.31.4, 1.32.4, 1.40.2, 1.43.0, 1.49.3, 1.52.0

Native libraries seen: libfilament-jni.so.

The Gradle change

implementation("com.google.android.filament:filament-android:1.53.0")

an aligned version, lowest measured above the last offending one; newer measured versions are aligned too (latest 1.77.1). Check: ./gradlew :app:dependencyInsight --dependency filament-android --configuration releaseRuntimeClasspath

Confirm what Gradle actually resolves, since another dependency may pull an older version:

./gradlew :app:dependencyInsight --dependency filament-android --configuration releaseRuntimeClasspath

Re-verify it yourself

Download the artifact and run the free checker (check16k.py, Python 3, no dependencies):

curl -LO https://repo1.maven.org/maven2/com/google/android/filament/filament-android/1.53.0/filament-android-1.53.0.aar
python3 check16k.py filament-android-1.53.0.aar

Exit 0 = aligned, 1 = an unaligned library found. Better still, run it on your final .aab/.apk.

Need the full map for every library, not just Filament?

The paid kit ($12, v2) contains the complete measured fix map for all 80+ libraries as JSON and a table, every raw per-version measurement, the spot-check evidence, and the step-by-step guide for Play's 16 KB requirement. This page and the checker script stay free.

Get the kit ($12)

Related artifacts

Filament utils (com.google.android.filament:filament-utils-android)
Filament gltfio (com.google.android.filament:gltfio-android)