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/local-setup.md (or send Accept: text/markdown).

Eseguire l'app mobile

Connetti Expo a un'API di sviluppo raggiungibile.

Chiedi informazioni su questa guida

1. Preparare il computer, il telefono e il backend

Completa prima di iniziare e aprire il repository Mobile o il monorepo All Platforms nel tuo editor. In Terminale → Nuovo terminale nella root del repository, esegui il comando di installazione riportato di seguito. Aspetta che finisca. Installa Expo Go sul tuo telefono utilizzando la pagina ufficiale Expo collegata di seguito; la sua versione deve supportare la versione Expo SDK registrata in apps/mobile/package.json.

Un backend è il server Web che gestisce l'accesso, i dati dell'area di lavoro e le richieste AI. Se il tuo checkout contiene apps/web, esegui prima la configurazione Web in un altro terminale e lascia il server in esecuzione. Completa la configurazione Postgres prima di provare la registrazione o l'accesso nativo. Un pagamento solo per dispositivi mobili non contiene apps/web: collegalo invece al backend in esecuzione, fornito separatamente. L'avvio di Expo avvia il server di anteprima dello schermo, non il backend.

Collega il telefono e il computer alla stessa rete Wi-Fi. Disconnettere temporaneamente uno VPN se blocca le connessioni locali. localhost di un telefono indica il telefono stesso. Utilizza l'indirizzo di rete privata del tuo computer per un telefono fisico o un dispositivo Android; Il simulatore iOS sullo stesso Mac può utilizzare http://localhost:3000, mentre l'emulatore Android utilizza comunemente http://10.0.2.2:3000.

corepack pnpm install

2. Trova e testa l'indirizzo back-end

Su Windows esegui ipconfig in un nuovo terminale PowerShell, trova l'adattatore Wi-Fi attivo e leggi l'indirizzo IPv4. Su macOS aprire Impostazioni di sistema → Wi-Fi → Dettagli → TCP/IP e leggere l'indirizzo IP. Su Linux apri le impostazioni di rete e leggi l'indirizzo IPv4. Un indirizzo potrebbe essere simile a 192.168.1.25; il tuo sarà solitamente diverso.

Se l'indirizzo del tuo computer è 192.168.1.25, apri http://192.168.1.25:3000 nel browser del telefono mentre il server Web è in esecuzione. Sostituisci il tuo indirizzo reale. La home page deve essere caricata prima di procedere. Consenti l'app Node su reti private se Windows Firewall lo richiede. Se non si carica, controlla l'indirizzo, il Wi-Fi, il firewall e il server Web in esecuzione; un tunnel Expo trasporta solo il pacchetto di anteprima e non rende raggiungibile il tuo API separato.

# Windows PowerShell only:
ipconfig

3. Crea il file di configurazione dell'app mobile

Nell'Explorer dell'editor, espandi app → mobili, crea un nuovo file denominato .env.local e incolla la configurazione seguente in quel file. Sostituisci 192.168.1.25 con l'indirizzo che hai appena testato o utilizza l'indirizzo backend HTTPS fornito. Salvare il file. Il suo percorso completo è apps/mobile/.env.local; root .env non viene letto automaticamente da Expo.

Mantieni disattivata l'impostazione dell'acquisto del telefono per la prima anteprima. EXPO_PUBLIC_ significa che un'impostazione è inclusa nell'app del telefono, quindi questi valori devono contenere solo URL pubblici, schemi e impostazioni del client pubblico. Non incollare qui i segreti del provider AI, del database o della fatturazione. Il server Web dispone del proprio apps/web/.env.local; la modifica del file Mobile non modifica il server.

EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=supastack
EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off

4. Avvia Expo e apri l'anteprima

Dalla root del repository, esegui il comando seguente. Attendi un codice QR e il messaggio di attesa Metro. Mantieni aperti questo terminale e il terminale di backend. Su Android apri Expo Go e scansiona il codice QR; su iPhone usa Fotocamera, scansiona il codice e aprilo in Expo Go. Il codice QR apre l'app di sviluppo, non la home page del backend.

L'esito positivo indica che la schermata di accesso dell'app si apre sul tuo dispositivo. Con gli acquisti disattivati, questa è un'anteprima dell'interfaccia utente; completare la configurazione dell'autenticazione Web supportata dal database prima di testare l'accesso, gli spazi di lavoro salvati o la chat. Se il tuo obiettivo è un simulatore installato, premi a nel terminale Expo per Android o i per iOS. Il simulatore iOS richiede macOS e Xcode; non può essere eseguito su Windows.

corepack pnpm --filter @supastack/mobile start

5. Recupera dagli errori di anteprima e testa i flussi reali

Se Expo Go segnala un progetto incompatibile, confronta il suo SDK supportato con apps/mobile/package.json e utilizza la versione compatibile dalla pagina ufficiale Expo. Non aggiornare le versioni delle dipendenze del kit solo per ignorare il messaggio. Se un modulo nativo richiesto non è disponibile, segui le build per dispositivi mobili per una build di sviluppo contenente quel modulo.

Se l'accesso non riesce a causa di un errore di rete, riprovare prima il backend URL nel browser del telefono. Se URL funziona ma l'accesso non riesce, ispeziona il terminale di backend e verifica Postgres e le migrazioni. La sessione demo locale/dashboard non ti consente di accedere al telefono. Se la configurazione sembra obsoleta, premi Ctrl + C nel terminale Expo, quindi esegui il comando di riavvio riportato di seguito e riapri l'anteprima.

Expo Go non può dimostrare il reale comportamento di acquisto/ripristino di StoreKit o Play Billing. Segui gli acquisti in-app e le build mobili per una build di sviluppo EAS e archivia gli account di prova. Le prime build native e la registrazione dell'account possono richiedere più di cinque minuti. Per interrompere questa anteprima, premi Ctrl + C nel terminale Expo; arrestare il backend separatamente una volta terminato.

corepack pnpm --filter @supastack/mobile start --clear

Per continuare la configurazione, leggi Autenticazione nativa.