From 11a964bd37e9b71d7a32860981ed247134f27e2d Mon Sep 17 00:00:00 2001
From: rzuasti <rzuasti@pm.me>
Date: Mon, 15 Jun 2026 14:42:40 -0400
Subject: [PATCH] Add Android release signing config for Play Store

Release builds were signed with the debug key, which Play rejects. Load
an upload keystore from android/key.properties (gitignored) and use it
for the release signing config, falling back to the debug key when the
file is absent so `flutter run --release` still works without a keystore.

Add key.properties.example documenting the keytool setup and a
build_android_release.sh helper that builds the signed AAB and refuses
to run when key.properties is missing.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 frontend/android/app/build.gradle.kts   | 36 ++++++++++++++++++++++---
 frontend/android/key.properties.example | 14 ++++++++++
 frontend/build_android_release.sh       | 20 ++++++++++++++
 3 files changed, 67 insertions(+), 3 deletions(-)
 create mode 100644 frontend/android/key.properties.example
 create mode 100755 frontend/build_android_release.sh

diff --git a/frontend/android/app/build.gradle.kts b/frontend/android/app/build.gradle.kts
index a0909c8..2be9468 100644
--- a/frontend/android/app/build.gradle.kts
+++ b/frontend/android/app/build.gradle.kts
@@ -1,3 +1,5 @@
+import java.util.Properties
+
 plugins {
     id("com.android.application")
     id("kotlin-android")
@@ -5,6 +7,15 @@ plugins {
     id("dev.flutter.flutter-gradle-plugin")
 }
 
+// Load the upload keystore credentials from key.properties (gitignored, never
+// committed). Absent on machines without the keystore (e.g. CI or a fresh
+// clone), in which case release builds fall back to the debug signing key.
+val keystoreProperties = Properties()
+val keystorePropertiesFile = rootProject.file("key.properties")
+if (keystorePropertiesFile.exists()) {
+    keystorePropertiesFile.inputStream().use { keystoreProperties.load(it) }
+}
+
 android {
     namespace = "net.oottsecurity.app"
     compileSdk = flutter.compileSdkVersion
@@ -31,11 +42,30 @@ android {
         versionName = flutter.versionName
     }
 
+    signingConfigs {
+        // Only registered when key.properties is present; otherwise release
+        // builds fall back to the debug key below.
+        if (keystorePropertiesFile.exists()) {
+            create("release") {
+                keyAlias = keystoreProperties["keyAlias"] as String
+                keyPassword = keystoreProperties["keyPassword"] as String
+                storeFile = file(keystoreProperties["storeFile"] as String)
+                storePassword = keystoreProperties["storePassword"] as String
+            }
+        }
+    }
+
     buildTypes {
         release {
-            // TODO: Add your own signing config for the release build.
-            // Signing with the debug keys for now, so `flutter run --release` works.
-            signingConfig = signingConfigs.getByName("debug")
+            // Sign with the upload key for Play Store builds. When key.properties
+            // is missing, fall back to the debug key so `flutter run --release`
+            // still works locally.
+            signingConfig =
+                if (keystorePropertiesFile.exists()) {
+                    signingConfigs.getByName("release")
+                } else {
+                    signingConfigs.getByName("debug")
+                }
         }
     }
 }
diff --git a/frontend/android/key.properties.example b/frontend/android/key.properties.example
new file mode 100644
index 0000000..ef06d2b
--- /dev/null
+++ b/frontend/android/key.properties.example
@@ -0,0 +1,14 @@
+# Template for android/key.properties (which is gitignored — NEVER commit the
+# real file or the keystore it points to).
+#
+# 1. Generate an upload keystore, storing it OUTSIDE the repo:
+#
+#      keytool -genkey -v -keystore ~/oott-upload-keystore.jks \
+#        -keyalg RSA -keysize 2048 -validity 10000 -alias upload
+#
+# 2. Copy this file to android/key.properties and fill in the values below.
+
+storePassword=<password chosen during keytool>
+keyPassword=<password chosen during keytool>
+keyAlias=upload
+storeFile=/absolute/path/to/oott-upload-keystore.jks
diff --git a/frontend/build_android_release.sh b/frontend/build_android_release.sh
new file mode 100755
index 0000000..89c9dd1
--- /dev/null
+++ b/frontend/build_android_release.sh
@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+#
+# Build the signed Android App Bundle (.aab) for the Google Play Store.
+#
+# Requires android/key.properties pointing at your upload keystore
+# (see android/key.properties.example). Without it the build falls back to the
+# debug signing key and Play will reject the upload.
+
+set -e
+
+if [ ! -f android/key.properties ]; then
+    echo "error: android/key.properties not found — release would be debug-signed." >&2
+    echo "       See android/key.properties.example to set up the upload keystore." >&2
+    exit 1
+fi
+
+flutter build appbundle --release
+
+echo
+echo "App bundle: build/app/outputs/bundle/release/app-release.aab"