For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /it/docs/mobile/troubleshooting.md (or send Accept: text/markdown).
Risoluzione dei problemi dell’app mobile
Correggi i guasti comuni di anteprima, configurazione e build nativa prima che raggiungano un tester.
Installazione e configurazione
Se l’app non raggiunge il backend, ricorda che localhost su un telefono significa il telefono. Usa l’indirizzo LAN del computer, 10.0.2.2 per l’emulatore Android o un URL HTTPS di staging. Apri prima quell’indirizzo nel browser del telefono; controlla Wi-Fi, firewall e VPN prima di modificare il codice. Un tunnel Expo trasporta il bundle dello schermo, non la tua API.
Un EXPO_PUBLIC_API_URL mancante o errato appare come errore di configurazione prima dell’accesso. Un callback rifiutato di solito significa che lo schema nella build e MOBILE_ALLOWED_ORIGINS sul server non coincidono, oppure che il callback è stato eseguito in Expo Go invece che nella build nativa.
Flusso di implementazione
Dopo una modifica a una dipendenza nativa o allo schema, ferma Metro, svuota la cache, ricostruisci il client di sviluppo e reinstalla l’app. Se è cambiato solo il JavaScript, basta ricaricare l’anteprima. Mantieni la versione dell’SDK Expo dell’app allineata a Expo Go o alla build di sviluppo installata sul dispositivo.
Verifica e risoluzione dei problemi
Anteprima, accesso e deep link funzionano sul dispositivo di destinazione.