Files

Davide Grilli 96f75df6f2 feat: supporto build APK release firmato nella pipeline Docker

- 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>

2026-03-28 10:10:43 +01:00

2.7 KiB

Raw Blame History

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)

2.7 KiB Raw Blame History