Publish Flutter App to Google Play: The End-to-End Release Guide

Publishing a Flutter app to Google Play requires careful configuration and attention to detail. Here is a step-by-step guide on how to do it.

First, you need to set up the release signing configuration. This is where most questions arise. Generate a release keystore and add the keystore details and passwords to android/key.properties. Also, include this information in android/app/build.gradle. The if (exists()) guard ensures that debug builds and CI environments without the keystore still work correctly.

Next, review the app/build.gradle settings for release. Make sure the namespace, compileSdk, minSdk, targetSdk, versionCode, and versionName are correct. Also, check for the Kotlin version and ensure it's compatible with the Flutter plugin.

For release builds, enable minifyEnabled, shrinkResources, and specify the Proguard rules. Don't forget to test the release bundle on a device to ensure everything works as expected.

Then, build the Android App Bundle (AAB) using the command: flutter build appbundle --release. This will output the app-release.aab file.

Now, upload the .aab file to the Google Play Console and select your app. Start with Internal testing, then promote through closed testing, open testing, and finally, to production. Always test on the internal track first to catch any issues before releasing to the public.

For store listing specifics, make sure screenshots are real and captured from the actual release build on real devices. Replace the default Flutter icon with a custom one. Fill out the data safety form, audit your plugins, and ensure all permissions are declared correctly. If your app has login, provide demo credentials in Play Console.

Lastly, be aware of common build failures and their fixes. Issues like Execution failed for task :app:validateSigningRelease usually occur when the signing config isn't resolving. Check that the key.properties file exists and that all passwords are correct.