Setting up Your Flutter Release Signing Key

Last updated: July 2025

You've just polished up your build, ran flutter build appbundle
, and you're ready to publish your build to the internal testing track. But you're greeted by the following error after uploading your first build:
You uploaded an APK or Android App Bundle that was signed in debug mode. You need to sign your APK or Android App Bundle in release mode.
Sound familiar? This guide is for you.
Background
I ran into this while setting up my first release for my caffeine-quitting app "Decaf" - these are the steps I took to solve it. I hope this guide helps you out!
Creating an Upload Keystore
Check out Flutter's Official Guide for this, it is perfect! Link Here
Once you are done, you will have
- Generated a Keystore
- Created a
key.properties
file - Updated your
build.gradle
file
And that is it! I hope this guide pointed you in the right direction. You should be able to upload your build to the Play Store with no errors.