From 65d0eb461c4520cf36d1b9992eff75a9358af57e Mon Sep 17 00:00:00 2001
From: Davide Grilli <davide.grilli@outlook.com>
Date: Mon, 13 Jul 2026 18:48:14 +0200
Subject: [PATCH] docs: guida step-by-step per testare l'APK di debug su
 emulatore

Aggiunge in README.md la procedura completa (avvio emulatore, adb
install, avvio app, log, disinstallazione) e corregge l'App ID
riportato in docker/README.md, disallineato dal valore reale in
android/app/build.gradle.kts.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 README.md        | 42 ++++++++++++++++++++++++++++++++++++++++++
 docker/README.md |  2 +-
 2 files changed, 43 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 7fac236..4194417 100644
--- a/README.md
+++ b/README.md
@@ -116,6 +116,48 @@ flutter run
 > **Nota WSL2**: serve un kernel con KVM abilitato (WSL2 recenti lo hanno di serie —
 > verifica con `ls /dev/kvm`). La finestra dell'emulatore compare tramite WSLg.
 
+### Installare e testare l'APK di debug sull'emulatore
+
+Una volta creato l'AVD `biteplan` (vedi sopra), per installare e provare un APK di debug
+già buildato (es. `dist/biteplan-debug.apk` generato da `bash docker/build.sh`) senza
+passare da `flutter run`:
+
+**1. Avvia l'emulatore e attendi il boot completo:**
+
+```bash
+emulator -avd biteplan &
+adb wait-for-device
+# poi attendi che il boot sia terminato (può richiedere 1-2 min al primo avvio):
+adb shell 'while [ "$(getprop sys.boot_completed)" != "1" ]; do sleep 1; done'
+```
+
+**2. Installa l'APK:**
+
+```bash
+adb install -r dist/biteplan-debug.apk   # -r = reinstalla sovrascrivendo se già presente
+```
+
+**3. Avvia l'app:**
+
+```bash
+adb shell monkey -p com.davide.biteplan -c android.intent.category.LAUNCHER 1
+```
+
+**4. Osserva i log in tempo reale (utile per debug):**
+
+```bash
+adb logcat --pid=$(adb shell pidof -s com.davide.biteplan)
+```
+
+**5. Disinstalla quando hai finito:**
+
+```bash
+adb uninstall com.davide.biteplan
+```
+
+> Per lo sviluppo iterativo (hot reload) usa invece `flutter run` — questa procedura serve
+> a validare l'APK esatto che verrà distribuito.
+
 ## Test
 
 La suite copre unit test e widget test. Richiede l'immagine Docker `biteplan-build`
diff --git a/docker/README.md b/docker/README.md
index 6678c2a..714c8e3 100644
--- a/docker/README.md
+++ b/docker/README.md
@@ -129,7 +129,7 @@ adb install dist/biteplan-debug.apk
 
 ## Note
 
-- App ID: `com.biteplan.biteplan`
+- App ID: `com.davide.biteplan`
 - Android target: API 34
 - Il keystore non viene mai copiato nell'immagine Docker (volume read-only)
 - `dist/` è in `.gitignore`