Davide Grilli
d1b0cdd8e0
- docker/Dockerfile: ambiente Node 20 + OpenJDK 17 + Android SDK 34 dist/ ricevuto come volume montato dall'host (non buildata nel container) - docker/build.sh: esegue npm run build locale poi lancia il container flag --head per buildare da HEAD ignorando modifiche non committate - docker/README.md: requisiti host (x86_64 obbligatorio), utilizzo, pipeline e note su prima build (~10-15 min) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
57 lines
1.3 KiB
Markdown
57 lines
1.3 KiB
Markdown
# Build APK — Docker
|
|
|
|
Genera un APK Android debug 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`, ecc.) sono binari nativi x86_64 e non girano su host ARM senza emulazione QEMU.
|
|
|
|
## Utilizzo
|
|
|
|
Dalla root del progetto:
|
|
|
|
```bash
|
|
# Build dalla working directory (file attuali)
|
|
bash docker/build.sh
|
|
|
|
# Build da HEAD (ignora modifiche non committate)
|
|
bash docker/build.sh --head
|
|
```
|
|
|
|
L'APK viene generato in `output/biteplan.apk`.
|
|
|
|
## 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
|
|
|
|
Con ADB:
|
|
|
|
```bash
|
|
adb install output/biteplan.apk
|
|
```
|
|
|
|
## Pipeline
|
|
|
|
```
|
|
[host] npm run build → dist/ (montato come volume in sola lettura)
|
|
[docker] cap sync → copia dist/ in android/assets/
|
|
[docker] gradlew assembleDebug
|
|
[host] output/biteplan.apk
|
|
```
|
|
|
|
## Note
|
|
|
|
- APK di tipo **debug**, non firmato per la produzione
|
|
- App ID: `com.davide.biteplan`
|
|
- Android target: API 34
|