RN Lezione 15: Build e Deploy con EAS

Obiettivi

• Configurare app.json con nome, icona, splash
• Compilare APK con EAS Build
• Installare l’APK su Android
• Opzioni di deploy

---

1. Configurare app.json

app.json è il file di configurazione principale dell’app Expo.

{
    "expo": {
        "name": "Mia App",
        "slug": "mia-app",
        "version": "1.0.0",
        "orientation": "portrait",
        "icon": "./assets/icon.png",
        "userInterfaceStyle": "light",
        "splash": {
            "image": "./assets/splash.png",
            "resizeMode": "contain",
            "backgroundColor": "#ffffff"
        },
        "ios": {
            "supportsTablet": true,
            "bundleIdentifier": "com.tuaclasse.miaapp"
        },
        "android": {
            "package": "com.tuaclasse.miaapp",
            "adaptiveIcon": {
                "foregroundImage": "./assets/adaptive-icon.png",
                "backgroundColor": "#ffffff"
            }
        },
        "extra": {
            "apiUrl": "https://miaapi.example.com"
        }
    }
}

Campi importanti

Campo	Descrizione
name	Nome visibile dell’app
slug	Identificatore unico (URL-friendly)
version	Versione (es. “1.0.0”)
orientation	"portrait" o "landscape"
icon	Icona app (1024×1024px PNG)
splash	Schermata di caricamento
android.package	Identificatore unico (es. com.nome.app)

---

2. Icone e Splash Screen

Preparare le immagini

Per Android servono:

assets/
├── icon.png            ← 1024×1024 (icona principale)
├── adaptive-icon.png   ← 1024×1024 (icona adattiva Android)
├── splash.png          ← 1284×2778 (schermata caricamento)
└── favicon.png         ← 48×48 (per web)

Puoi generare icone con icon.kitchen o appicon.co.

Icon semplici: usa emoji o lettera su sfondo colorato!

---

3. EAS Build — compilare APK

EAS (Expo Application Services) è il servizio cloud che compila l’app per noi.

Step 1: Installare EAS CLI

npx expo install expo-device
npm install -g eas-cli

Step 2: Login ad Expo

eas login
# (crea un account gratis su expo.dev se non lo hai)

Step 3: Configurare la build

eas build:configure

Questo crea eas.json:

{
    "cli": {
        "version": ">= 3.0.0"
    },
    "build": {
        "development": {
            "developmentClient": true,
            "distribution": "internal"
        },
        "preview": {
            "android": {
                "buildType": "apk"
            }
        },
        "production": {}
    },
    "submit": {
        "production": {}
    }
}

Step 4: Compilare APK

# Build APK per Android
eas build -p android --profile preview

Vedrai un link nel terminale. La build richiede 5-15 minuti (cloud).

Step 5: Scaricare e installare

1. Quando la build finisce, vedrai un link per scaricare l’APK
2. Trasferisci l’APK sul telefono (scaricandolo o via USB)
3. Sul telefono: apri il file APK → installa
4. Potrebbe chiedere “Installa da fonti sconosciute” → abilita

---

4. Build APK locale (alternativa didattica)

Se non vuoi usare EAS cloud, puoi buildare localmente:

# Richiede Android Studio installato
npx expo run:android

Ma è più complesso: richiede Android Studio, SDK, configurazioni.

Consiglio didattico: usa EAS Cloud per la build finale. Gratis per progetti piccoli.

---

5. Rilasciare su Google Play (opzionale)

1. Crea account sviluppatore Google Play ($25 una tantum)

2. Prepara APK con firma di produzione:

   eas build -p android --profile production

3. Carica su Google Play Console

4. Compila scheda dell’app (descrizione, screenshot, categorie)

5. Pubblica

Per la scuola, di solito ci si ferma all’APK installato direttamente.

---

6. Checklist build

• Immagine icon (1024×1024) in assets/
• app.json configurato con nome e package
• App funzionante su Expo Go
• eas-cli installato
• Login Expo effettuato
• eas build:configure eseguito
• eas build -p android --profile preview → APK
• APK installato su telefono e funzionante!