Android App Signing for Flutter: Quick Setup Guide

Shohruh AK

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 keytool not found:

    • Run:

      flutter doctor -v
      
    • Locate Java binary path and replace java → keytool.

  • -storetype JKS is 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