davide
36e8034efd
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>
105 lines
2.5 KiB
Markdown
105 lines
2.5 KiB
Markdown
# 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.
|
|
|
|
```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
|
|
# 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:
|
|
|
|
```bash
|
|
flutter create --project-name biteplan --org com.biteplan .
|
|
```
|
|
|
|
### Build debug
|
|
|
|
APK firmato con il debug keystore di Android — adatto per test su dispositivo.
|
|
|
|
```bash
|
|
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)**
|
|
|
|
```bash
|
|
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
|
|
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)
|