davide
cba83c9559
Guida utente: - Pulsante info nell'AppBar principale - InfoBottomSheet: icona app, versione, autore, licenza, link alla guida - GuidePage: tre tab (Pasti / Converti / Spesa) con card e step numerati, portata dalla DocsPanel Vue originale AppBar globale in app.dart con titolo dinamico per tab corrente. Icona launcher: - flutter_launcher_icons eseguito in build.sh prima di flutter build apk (sia debug che release) per applicare assets/icon-only.png all'APK. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Docker — BitePlan
Due container distinti: uno per lo sviluppo, uno per la build APK.
Container dev (docker/dev/)
Avvia un web server Flutter con hot reload accessibile dal browser.
cd docker/dev
docker compose up
Apri http://localhost:5173 nel browser.
Hot reload — con il container attivo, in un altro terminale:
docker compose attach dev
# premi '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 Flutter SDK (~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.
Prerequisito: la cartella android/ deve esistere nel progetto.
Se non esiste, generala con Flutter installato localmente o nel container dev:
flutter create --project-name biteplan --org com.biteplan .
Build debug
APK firmato con il debug keystore di Android — adatto per test su dispositivo.
bash docker/build/build.sh
# → dist/biteplan-debug.apk
Build release
APK firmato con keystore personale — necessario per la distribuzione.
1. Genera il keystore (una sola volta)
keytool -genkey -v \
-keystore docker/biteplan.jks \
-alias biteplan \
-keyalg RSA -keysize 2048 -validity 10000
docker/biteplan.jksè in.gitignore— non verrà mai committato. Conservalo in un posto sicuro: senza di esso non puoi pubblicare aggiornamenti.
2. Esegui la build release
bash docker/build/build.sh --release
# → dist/biteplan-release.apk
Il keystore viene montato nel container come volume read-only e non viene mai copiato nell'immagine Docker.
Prima esecuzione: scarica Flutter SDK + Android SDK (~1-2 GB), richiede 10-15 minuti.
Flusso completo
cd docker/dev && docker compose up
→ http://localhost:5173 (sviluppo con hot reload)
↓
flutter create --project-name biteplan --org com.biteplan .
(una volta sola, genera android/)
↓
bash docker/build/build.sh # → dist/biteplan-debug.apk
bash docker/build/build.sh --release # → dist/biteplan-release.apk
↓
adb install dist/biteplan-debug.apk
Note
- App ID:
com.biteplan.biteplan - Android target: API 34
- Il keystore non viene mai copiato nell'immagine Docker (volume read-only)