From d1b0cdd8e01c2fd5993338c6acb270a35acf91b0 Mon Sep 17 00:00:00 2001
From: Davide Grilli <davide.grilli@outlook.com>
Date: Wed, 25 Mar 2026 10:24:19 +0100
Subject: [PATCH] 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>
---
 docker/Dockerfile | 58 +++++++++++++++++++++++++++++++++++++++++++++++
 docker/README.md  | 56 +++++++++++++++++++++++++++++++++++++++++++++
 docker/build.sh   | 50 ++++++++++++++++++++++++++++++++++++++++
 3 files changed, 164 insertions(+)
 create mode 100644 docker/Dockerfile
 create mode 100644 docker/README.md
 create mode 100755 docker/build.sh

diff --git a/docker/Dockerfile b/docker/Dockerfile
new file mode 100644
index 0000000..09a2666
--- /dev/null
+++ b/docker/Dockerfile
@@ -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"
diff --git a/docker/README.md b/docker/README.md
new file mode 100644
index 0000000..6cfc204
--- /dev/null
+++ b/docker/README.md
@@ -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
diff --git a/docker/build.sh b/docker/build.sh
new file mode 100755
index 0000000..54f547b
--- /dev/null
+++ b/docker/build.sh
@@ -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"