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>
This commit is contained in:
@@ -116,6 +116,48 @@ flutter run
|
|||||||
> **Nota WSL2**: serve un kernel con KVM abilitato (WSL2 recenti lo hanno di serie —
|
> **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.
|
> 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
|
## Test
|
||||||
|
|
||||||
La suite copre unit test e widget test. Richiede l'immagine Docker `biteplan-build`
|
La suite copre unit test e widget test. Richiede l'immagine Docker `biteplan-build`
|
||||||
|
|||||||
+1
-1
@@ -129,7 +129,7 @@ adb install dist/biteplan-debug.apk
|
|||||||
|
|
||||||
## Note
|
## Note
|
||||||
|
|
||||||
- App ID: `com.biteplan.biteplan`
|
- App ID: `com.davide.biteplan`
|
||||||
- Android target: API 34
|
- Android target: API 34
|
||||||
- Il keystore non viene mai copiato nell'immagine Docker (volume read-only)
|
- Il keystore non viene mai copiato nell'immagine Docker (volume read-only)
|
||||||
- `dist/` è in `.gitignore`
|
- `dist/` è in `.gitignore`
|
||||||
|
|||||||
Reference in New Issue
Block a user