Android App Signing for Flutter: Quick Setup Guide
Shohruh AK
Flutter Engineer | Content Creator
May 5, 2026
A step-by-step guide for setting up Android app signing for Flutter apps.
š Android App Signing (Flutter) ā Complete Guide
1. Create a Keystore (Skip if you already have one)
Option A ā Android Studio
- Use built-in Generate Signed Bundle/APK wizard.
Option B ā Command Line
macOS / Linux:
keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA \
-storetype JKS -keysize 2048 -validity 10000 -alias upload
Windows (PowerShell):
keytool -genkey -v -keystore $env:USERPROFILE\upload-keystore.jks `
-storetype JKS -keyalg RSA -keysize 2048 -validity 10000 `
-alias upload
Important Notes
-
Keystore is saved in your home directory by default.
-
Keep it private (never commit to Git).
-
If
keytoolnot found:-
Run:
flutter doctor -v -
Locate Java binary path and replace
javaākeytool.
-
-
-storetype JKSis only needed for Java 9+ (default is PKCS12 otherwise).
2. Create key.properties
Create file:
<project>/android/key.properties
Add:
storePassword=YOUR_STORE_PASSWORD
keyPassword=YOUR_KEY_PASSWORD
keyAlias=upload
storeFile=YOUR_KEYSTORE_PATH
Path Examples
-
macOS:
/Users/username/upload-keystore.jks -
Windows:
C:\\Users\\username\\upload-keystore.jks
ā ļø Use double backslashes on Windows ā ļø Never commit this file
3. Configure Gradle
Open:
android/app/build.gradle.kts (Kotlin)
or
android/app/build.gradle (Groovy)
3.1 Load Properties (Top of file)
Kotlin:
import java.util.Properties
import java.io.FileInputStream
val keystoreProperties = Properties()
val keystorePropertiesFile = rootProject.file("key.properties")
if (keystorePropertiesFile.exists()) {
keystoreProperties.load(FileInputStream(keystorePropertiesFile))
}
Groovy:
import java.util.Properties
import java.io.FileInputStream
def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}
3.2 Add Signing Config (inside android {})
Kotlin:
signingConfigs {
create("release") {
keyAlias = keystoreProperties["keyAlias"] as String
keyPassword = keystoreProperties["keyPassword"] as String
storeFile = keystoreProperties["storeFile"]?.let { file(it) }
storePassword = keystoreProperties["storePassword"] as String
}
}
Groovy:
signingConfigs {
release {
keyAlias = keystoreProperties['keyAlias']
keyPassword = keystoreProperties['keyPassword']
storeFile = keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
storePassword = keystoreProperties['storePassword']
}
}
3.3 Attach Signing to Release Build
Kotlin:
buildTypes {
release {
signingConfig = signingConfigs.getByName("release")
}
}
Groovy:
buildTypes {
release {
signingConfig = signingConfigs.release
}
}
4. Build the Release
flutter build appbundle
or
flutter build apk --release
5. Final Step (Recommended)
After changes:
flutter clean
flutter pub get
ā Result
- Your app is now properly signed
- Ready for:
- Google Play upload (
.aab) - Production release
- Google Play upload (