One of our partners upgraded their Android build tools and their app stopped building. The cause wasn't their code. It was a single outdated line in our Flutter plugins, pointing at a download server the new tools no longer know about.

The fix is two lines per plugin. The more interesting story is why it happened, why the fix lives where it does, and why we're deliberately not shipping the bigger upgrade at the same time.

A 60-second primer 🧠

Three names that come up regulary:

Gradle is the build tool. It takes an Android project, downloads the libraries it needs and compiles it into an app. Think of it as the kitchen.

AGP (Android Gradle Plugin) is Google's add-on that teaches Gradle how to build Android apps. It's the recipe book, and it has versions: 8.x, and now 9.x.

Kotlin is the language our Android plugin code is written in. Until AGP 9 you needed a separate Kotlin add-on (KGP), like a second cookbook.…