aggiungi setup Docker per build APK Android

- 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>
This commit is contained in:
2026-03-25 10:24:19 +01:00
parent 644ae01f7e
commit d1b0cdd8e0
3 changed files with 164 additions and 0 deletions

58
docker/Dockerfile Normal file
View File

@@ -0,0 +1,58 @@
# ── Android SDK + Node (ambiente di build) ────────────────────────────────────
FROM node:20-slim
# Dipendenze di sistema
RUN apt-get update && apt-get install -y --no-install-recommends \
openjdk-17-jdk-headless \
wget \
unzip \
&& rm -rf /var/lib/apt/lists/*
# ── Android SDK ─────────────────────────────────────────────────────────────────
ENV ANDROID_HOME=/opt/android-sdk
ENV PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools
RUN mkdir -p $ANDROID_HOME/cmdline-tools && \
wget -q https://dl.google.com/android/repository/commandlinetools-linux-11076708_latest.zip \
-O /tmp/cmdline-tools.zip && \
unzip -q /tmp/cmdline-tools.zip -d /tmp && \
mv /tmp/cmdline-tools $ANDROID_HOME/cmdline-tools/latest && \
rm /tmp/cmdline-tools.zip
RUN yes | sdkmanager --licenses > /dev/null && \
sdkmanager \
"platform-tools" \
"platforms;android-34" \
"build-tools;34.0.0"
# ── Progetto (solo dipendenze npm, senza sorgenti) ────────────────────────────
WORKDIR /app
COPY package*.json ./
RUN npm ci
# ── Capacitor config ──────────────────────────────────────────────────────────
RUN cat > capacitor.config.json <<'EOF'
{
"appId": "com.davide.biteplan",
"appName": "BitePlan",
"webDir": "dist",
"server": {
"androidScheme": "https"
}
}
EOF
# ── Installa Capacitor e prepara la piattaforma Android ───────────────────────
RUN npm install @capacitor/core @capacitor/cli @capacitor/android --save
RUN npx cap add android
# ── Runtime: dist/ viene montato come volume dall'host ────────────────────────
# build.sh esegue: docker run -v ./dist:/app/dist ...
# Qui cap sync copia dist/ in android/assets, poi Gradle builda l'APK
CMD npx cap sync android && \
cd android && chmod +x gradlew && ./gradlew assembleDebug --no-daemon && \
cp app/build/outputs/apk/debug/app-debug.apk /output/biteplan.apk && \
echo "APK generato: /output/biteplan.apk"

56
docker/README.md Normal file
View File

@@ -0,0 +1,56 @@
# 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

50
docker/build.sh Executable file
View File

@@ -0,0 +1,50 @@
#!/usr/bin/env bash
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
OUTPUT_DIR="$PROJECT_ROOT/output"
DIST_DIR="$PROJECT_ROOT/dist"
FROM_HEAD=false
for arg in "$@"; do
[[ "$arg" == "--head" ]] && FROM_HEAD=true
done
echo "==> Preparazione cartelle..."
mkdir -p "$OUTPUT_DIR"
# ── Build Vite ────────────────────────────────────────────────────────────────
if $FROM_HEAD; then
COMMIT_SHA=$(git -C "$PROJECT_ROOT" rev-parse --short HEAD)
echo "==> Build Vite da HEAD ($COMMIT_SHA)..."
TMPDIR=$(mktemp -d)
trap 'rm -rf "$TMPDIR"' EXIT
git -C "$PROJECT_ROOT" archive HEAD | tar -x -C "$TMPDIR"
cd "$TMPDIR"
npm ci --silent
npm run build --silent
DIST_DIR="$TMPDIR/dist"
cd "$PROJECT_ROOT"
else
echo "==> Build Vite dalla working directory..."
cd "$PROJECT_ROOT"
npm run build --silent
fi
# ── Build immagine Docker ─────────────────────────────────────────────────────
echo "==> Build immagine Docker..."
docker build \
-f "$SCRIPT_DIR/Dockerfile" \
-t biteplan-builder \
"$PROJECT_ROOT"
# ── Generazione APK (dist/ montato come volume) ───────────────────────────────
echo "==> Generazione APK..."
docker run --rm \
-v "$DIST_DIR:/app/dist:ro" \
-v "$OUTPUT_DIR:/output" \
biteplan-builder
echo ""
echo "APK pronto in: $OUTPUT_DIR/biteplan.apk"