davide/biteplan
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: aggiorna README e docker/README al nuovo workflow di sviluppo

Browse Source 
Sostituisce le istruzioni per il container dev con Flutter host +
emulatore Android; aggiorna i path docker/build/build.sh → docker/build.sh.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Davide Grilli
2026-07-12 19:30:34 +02:00
parent 59c4915847
commit 6f82aa0225
2 changed files with 19 additions and 54 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+8 -15
View File
@@ -40,27 +40,20 @@ App Android per la gestione della dieta quotidiana — pianificazione pasti, con
## Sviluppo ## Sviluppo
Il container dev avvia un web server Flutter accessibile dal browser, con hot reload. Sviluppo locale con Flutter installato sull'host e un emulatore Android dedicato — no Docker.
```bash ```bash
cd docker/dev emulator -avd biteplan &
docker compose up flutter run
# → http://localhost:5173 # hot reload con "r", hot restart con "R"
``` ```
Con il container attivo, in un altro terminale: Vedi [docker/README.md](docker/README.md) per test e build APK via Docker.
```bash
docker compose attach dev
# r → hot reload | R → hot restart | q → esci
```
Vedi [docker/README.md](docker/README.md) per i dettagli e la build APK.
## 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`
(creata automaticamente al primo `bash docker/build/build.sh`). (creata automaticamente al primo `bash docker/build.sh`).
```bash ```bash
# Tutti i test (dalla root del progetto) # Tutti i test (dalla root del progetto)
@@ -101,8 +94,8 @@ test/
## Build APK ## Build APK
```bash ```bash
bash docker/build/build.sh # debug → dist/biteplan-debug.apk bash docker/build.sh # debug → dist/biteplan-debug.apk
bash docker/build/build.sh --release # release → dist/biteplan-release.apk bash docker/build.sh --release # release → dist/biteplan-release.apk
``` ```
Vedi [docker/README.md](docker/README.md) per i requisiti della firma release. Vedi [docker/README.md](docker/README.md) per i requisiti della firma release.
docker/README.md
+11 -39
View File
@@ -1,39 +1,12 @@
# Docker — BitePlan # Docker — BitePlan
Due container distinti: uno per lo sviluppo con hot reload, uno per la build APK headless. Un solo container, usato per test riproducibili e build APK headless.
Lo sviluppo (hot reload) avviene sull'host con Flutter + emulatore Android — vedi `CLAUDE.md`.
Tutti i comandi vanno eseguiti dalla **root del progetto** (`~/biteplan`), non da `docker/`. Tutti i comandi vanno eseguiti dalla **root del progetto** (`~/biteplan`), non da `docker/`.
--- ---
## Container dev (`docker/dev/`) ## Container build (`docker/`)
Avvia un web server Flutter accessibile dal browser, con hot reload.
```bash
cd docker/dev
docker compose up
```
Apri **http://localhost:5173** nel browser.
### Hot reload
Con il container attivo, in un altro terminale:
```bash
docker compose attach dev
# r → hot reload | R → hot restart | q → esci
```
Le modifiche ai file `.dart` sull'host sono visibili subito nel container grazie al volume
montato — basta premere `r` per ricaricare.
> Prima esecuzione: scarica l'immagine Flutter (~500 MB), richiede 5-10 minuti.
> Le successive usano la cache Docker e sono molto più rapide.
---
## Container build (`docker/build/`)
Build headless riproducibile per generare l'APK Android. Build headless riproducibile per generare l'APK Android.
@@ -42,7 +15,7 @@ Build headless riproducibile per generare l'APK Android.
APK firmato con il debug keystore di Android — adatto per installazione diretta sul dispositivo. APK firmato con il debug keystore di Android — adatto per installazione diretta sul dispositivo.
```bash ```bash
bash docker/build/build.sh bash docker/build.sh
# → dist/biteplan-debug.apk # → dist/biteplan-debug.apk
``` ```
@@ -83,7 +56,7 @@ aggiungila a `~/.bashrc` o `~/.zshrc`.
**3. Esegui la build release** **3. Esegui la build release**
```bash ```bash
bash docker/build/build.sh --release bash docker/build.sh --release
# → dist/biteplan-release.apk # → dist/biteplan-release.apk
``` ```
@@ -107,8 +80,7 @@ adb install dist/biteplan-debug.apk
## Test ## Test
I test non richiedono il container dev — usano l'immagine `biteplan-build`, creata I test usano l'immagine `biteplan-build`, creata automaticamente al primo `bash docker/build.sh`.
automaticamente al primo `bash docker/build/build.sh`.
```bash ```bash
# Tutti i test (110 test — unit + widget) # Tutti i test (110 test — unit + widget)
@@ -137,17 +109,17 @@ avere Flutter installato sull'host.
## Flusso completo ## Flusso completo
``` ```
# 1. Sviluppo # 1. Sviluppo (host, no Docker — vedi CLAUDE.md)
cd docker/dev && docker compose up emulator -avd biteplan &
→ http://localhost:5173 (hot reload con 'r') flutter run
# 2. Test # 2. Test
docker run --rm -v "$(pwd):/workspace" -w /workspace biteplan-build \ docker run --rm -v "$(pwd):/workspace" -w /workspace biteplan-build \
bash -c "flutter pub get && flutter test" bash -c "flutter pub get && flutter test"
# 3. Build # 3. Build
bash docker/build/build.sh # → dist/biteplan-debug.apk bash docker/build.sh # → dist/biteplan-debug.apk
bash docker/build/build.sh --release # → dist/biteplan-release.apk bash docker/build.sh --release # → dist/biteplan-release.apk
# 4. Installazione # 4. Installazione
adb install dist/biteplan-debug.apk adb install dist/biteplan-debug.apk