Configura l’app mobile

Installazione e configurazione

Inserisci i valori destinati al dispositivo in apps/mobile/.env.local; Expo legge quel file, non il .env nella radice del repository. EXPO_PUBLIC_API_URL è l’origine del backend web raggiungibile dal telefono — lo stesso valore provato nel browser del telefono. EXPO_PUBLIC_APP_SCHEME è lo schema URI nativo dell’app; usa un valore DNS inverso come com.example.app.

app.json gestisce nome del prodotto, slug, versione, bundle identifier e plugin. app.config.ts deriva lo schema dei deep link e le origini di produzione da EXPO_PUBLIC_APP_SCHEME, quindi un cambio di schema richiede una nuova build nativa, non solo un riavvio di Metro. Sul server aggiungi ogni origine usata dall’app a MOBILE_ALLOWED_ORIGINS; il passaggio fallisce in modo sicuro quando i due lati non coincidono.

Ogni valore EXPO_PUBLIC_* viene incluso nel bundle dell’app. Mantieni le chiavi dei provider sul server e usa valori pubblici solo per indirizzi e schemi.

EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=com.example.app

Flusso di implementazione

Riavvia Expo dopo aver modificato .env.local. Esegui i test e il controllo dei tipi del pacchetto, poi conferma lo schema risolto con una build di sviluppo: apri un link di callback di autenticazione e verifica che torni all’app invece che al browser. Expo Go non può validare schemi personalizzati della tua build nativa.

Verifica e risoluzione dei problemi

Riavvia Expo dopo aver modificato .env.local e apri l’anteprima sul dispositivo di destinazione. Cambia il tema, riavvia l’app e conferma che la scelta persiste; poi attiva un deep link e verifica che l’app lo gestisca invece del browser.