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
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
cd docker/dev
docker compose up
# → http://localhost:5173
emulator -avd biteplan &
flutter run
# hot reload con "r", hot restart con "R"
```
Con il container attivo, in un altro terminale:
```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.
Vedi [docker/README.md](docker/README.md) per test e build APK via Docker.
## Test
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
# Tutti i test (dalla root del progetto)
@@ -101,8 +94,8 @@ test/
## Build APK
```bash
bash docker/build/build.sh # debug → dist/biteplan-debug.apk
bash docker/build/build.sh --release # release → dist/biteplan-release.apk
bash docker/build.sh # debug → dist/biteplan-debug.apk
bash docker/build.sh --release # release → dist/biteplan-release.apk
```
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
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/`.
---
## Container dev (`docker/dev/`)
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/`)
## Container build (`docker/`)
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.
```bash
bash docker/build/build.sh
bash docker/build.sh
# → dist/biteplan-debug.apk
```
@@ -83,7 +56,7 @@ aggiungila a `~/.bashrc` o `~/.zshrc`.
**3. Esegui la build release**
```bash
bash docker/build/build.sh --release
bash docker/build.sh --release
# → dist/biteplan-release.apk
```
@@ -107,8 +80,7 @@ adb install dist/biteplan-debug.apk
## Test
I test non richiedono il container dev — usano l'immagine `biteplan-build`, creata
automaticamente al primo `bash docker/build/build.sh`.
I test usano l'immagine `biteplan-build`, creata automaticamente al primo `bash docker/build.sh`.
```bash
# Tutti i test (110 test — unit + widget)
@@ -137,17 +109,17 @@ avere Flutter installato sull'host.
## Flusso completo
```
# 1. Sviluppo
cd docker/dev && docker compose up
→ http://localhost:5173 (hot reload con 'r')
# 1. Sviluppo (host, no Docker — vedi CLAUDE.md)
emulator -avd biteplan &
flutter run
# 2. Test
docker run --rm -v "$(pwd):/workspace" -w /workspace biteplan-build \
bash -c "flutter pub get && flutter test"
# 3. Build
bash docker/build/build.sh # → dist/biteplan-debug.apk
bash docker/build/build.sh --release # → dist/biteplan-release.apk
bash docker/build.sh # → dist/biteplan-debug.apk
bash docker/build.sh --release # → dist/biteplan-release.apk
# 4. Installazione
adb install dist/biteplan-debug.apk