Davide Grilli
96f75df6f2
- Dockerfile: CMD condizionale su BUILD_TYPE (debug default, release con assembleRelease + zipalign + apksigner) - build.sh: flag --release, richiesta password interattiva, mount keystore come volume read-only (mai nell'immagine) - .gitignore: aggiunto *.jks - docker/README.md: documentazione build debug/release, keytool, flag combinabili Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Build APK — Docker
Genera un APK Android senza installare nulla sull'host oltre a Docker.
Requisiti host
| Requisito | Dettaglio |
|---|---|
| Architettura | x86_64 (amd64) — ARM/aarch64 non supportato |
| OS | Linux x86_64 o macOS x86_64 |
| Docker | Installato e avviato |
| Node.js | v18+ (per il build Vite locale) |
Gli Android build-tools (
aapt2,zipalign,apksigner) sono binari nativi x86_64 e non girano su host ARM senza emulazione QEMU.
Build debug (default)
APK firmato con il debug keystore di Android. Adatto per test su dispositivo.
bash docker/build.sh
Build release (distribuzione)
APK firmato con il tuo keystore personale. Necessario per distribuire l'app.
1. Genera il keystore (una volta sola)
keytool -genkey -v \
-keystore docker/biteplan.jks \
-alias biteplan \
-keyalg RSA \
-keysize 2048 \
-validity 10000
Il file
docker/biteplan.jksè già in.gitignore— non verrà mai committato. Conservalo in un posto sicuro: senza di esso non puoi aggiornare l'app.
2. Esegui la build release
bash docker/build.sh --release
# chiede interattivamente: Password keystore / Password chiave
Oppure passando le password come variabili d'ambiente (utile in CI):
KEYSTORE_PASS=tuapassword KEY_PASS=tuapassword bash docker/build.sh --release
Per usare un keystore in un percorso diverso da docker/biteplan.jks:
KEYSTORE_PATH=/percorso/biteplan.jks bash docker/build.sh --release
3. Verifica la firma
$ANDROID_HOME/build-tools/34.0.0/apksigner verify --verbose dist/biteplan.apk
Flag combinabili
| Comando | Risultato |
|---|---|
bash docker/build.sh |
APK debug dalla working directory |
bash docker/build.sh --head |
APK debug dall'ultimo commit git |
bash docker/build.sh --release |
APK release firmato dalla working directory |
bash docker/build.sh --head --release |
APK release firmato dall'ultimo commit git |
Prima build
La prima esecuzione scarica Android SDK (~1 GB) e può richiedere 10-15 minuti. Le build successive usano la cache Docker e sono molto più rapide.
Installazione su dispositivo
adb install dist/biteplan.apk
Pipeline
[host] npm run build → dist/
[docker] cap sync → copia dist/ in android/assets/
[docker] gradlew assembleDebug/Release
[docker] zipalign + apksigner → solo in modalità release
[host] dist/biteplan.apk
Note
- App ID:
com.davide.biteplan - Android target: API 34
- Il keystore non viene mai copiato nell'immagine Docker (montato come volume read-only)