Home › Build error fixes › Android / Gradle

Gradle ran out of memory

Android / Gradle · last reviewed 2026-11-10

The error looks like this

java.lang.OutOfMemoryError: Metaspace

Why it happens

Default JVM heap is too small for release builds with R8.

How to fix it

  1. android/gradle.properties: org.gradle.jvmargs=-Xmx4g -XX:MaxMetaspaceSize=1g
  2. CI: use a larger runner or disable parallel workers.

Not sure this is your error? Let ReleaseMedic read the whole log

Build logs are long and the last line is rarely the real cause. ReleaseMedic finds the first real error, explains it and gives the steps — free, and the log never leaves your computer.

$ npx releasemedic log build.log

Or pipe a build straight in: cd android && ./gradlew bundleRelease 2>&1 | npx releasemedic log -

Catch it before you build

Most release errors come from project settings you can check in seconds — signing, SDK levels, privacy manifests, permissions, push and login setup.

$ npx releasemedic

Related Android / Gradle errors