Files
biteplan/docker
davide 36e8034efd feat: aggiungi container Docker dev e build per Flutter
docker/build/: build headless APK Android
- Dockerfile: Ubuntu 22.04 + Java 17 + Flutter stable + Android SDK
- build.sh: genera android/ automaticamente se mancante, poi
  flutter build apk; --release aggiunge zipalign + apksigner

docker/dev/: ambiente di sviluppo web con hot reload
- Dockerfile: Ubuntu 22.04 + Flutter stable (solo web, senza Android SDK)
- docker-compose.yml: espone porta 5173, monta il progetto come volume
- entrypoint.sh: inizializza web/ se mancante, flutter pub get,
  flutter run -d web-server su 0.0.0.0:5173

docker/README.md: documentazione aggiornata per entrambi i container;
rimossi Dockerfile e build.sh Vue/Capacitor non più usati.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-16 18:25:48 +02:00
..

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)