Testare iOS da una macchina Windows o Linux si riduce a un fatto: il Simulatore iOS e Safari Web Inspector sono solo per macOS. Tutto il resto si può organizzare. Questa guida delinea una scala di test che funziona senza un Mac, dal browser a un iPhone reale, e mostra dove Build Capgo e Live Update eliminare l'attesa.
La scala di test
| Livello | Cosa si testa | Dove viene eseguito | Richiede un Mac |
|---|---|---|---|
| 1 | Livello web: logica, layout, design responsive | Browser desktop con viewport iPhone | No |
| 2 | plugin Capacitor, bridge nativo, permessi | Emulatore o dispositivo Android | No |
| 3 | Comportamento iOS reale: stranezze di WebKit, safe areas, tastiera, push, plugin iOS | iPhone tramite TestFlight | No, con Capgo Build |
| 4 | Build QA ad hoc per dispositivi specifici | iPhone tramite IPA Ad Hoc | No, con Capgo Build |
| 5 | Debug nativo passo-passo in Xcode | Mac | Sì |
La maggior parte dei bug viene intercettata ai livelli 1 e 2. Il livello 3 intercetta quelli esclusivi di iOS. Il livello 5 è raro per un'app Capacitor, e quando succede noleggiare un Mac per un'ora costa meno che comprarne uno.
Livello 1: il browser con viewport iPhone
Apri il dev server in Chrome o Edge, attiva l'emulazione del dispositivo e seleziona un profilo iPhone. Capacitor espone le informazioni sulla piattaforma, così puoi gestire la UI in base al contesto:
import { Capacitor } from '@capacitor/core';
if (Capacitor.getPlatform() === 'ios') {
// iOS-only behavior
}
Cosa non viene rilevato: differenze di rendering WebKit, safe area insets, la tastiera iOS che sposta il viewport e qualsiasi interazione con un plugin nativo.
Livello 2: prima Android, perché la web layer è condivisa
Capacitor esegue lo stesso web bundle su entrambe le piattaforme. La configurazione dei plugin, i prompt di autorizzazione e le chiamate al bridge possono essere validati su Android da Windows o Linux con Chrome DevTools in chrome://inspect. Se una chiamata al plugin funziona su Android, la parte JavaScript è corretta; resta da testare l'implementazione nativa iOS, che si verifica al livello 3.
Guide di configurazione: Windows e Linux.
Livello 3: un vero iPhone tramite TestFlight
Questa è la principale via di test iOS senza Mac. Flusso:
- Genera e sincronizza il progetto iOS localmente.
- Richiedi una build cloud con le credenziali di App Store Connect salvate.
- Apri TestFlight sull'iPhone.
bun run build
bunx cap sync ios
bunx @capgo/cli@latest build request com.example.app --platform ios --build-mode release
Capgo compila e firma l'app su macOS, poi la carica su App Store Connect. Apple elabora la build e TestFlight la mostra ai tester interni in pochi minuti. I tester interni (membri del tuo team App Store Connect) non necessitano della Beta App Review, quindi la prima installazione è rapida.
Credentials setup is a one-time job; bunx @capgo/cli@latest build init --platform ios ti guida, e il certificato può essere creato senza Mac usando OpenSSL o il Generatore di certificati iOS.
Cosa ottieni sul dispositivo: WebKit reale, safe area reali, la tastiera reale, notifiche push reali, comportamento dei plugin reale. Questa è la lista delle cose che il browser non poteva dirti.
Livello 4: build ad hoc per dispositivi specifici
Quando un tester non fa parte del tuo team App Store Connect, o vuoi saltare l'elaborazione di Apple, usa un profilo Ad Hoc che elenchi l'UDID del dispositivo:
bunx @capgo/cli@latest build request com.example.app \
--platform ios \
--ios-distribution ad_hoc \
--output-upload \
--output-record build.json
Il CLI restituisce un link di download con scadenza e un QR code per l'IPA. La retention è configurabile da 1 ora a 7 giorni con --output-retention. I profili ad hoc non richiedono la chiave API di App Store Connect, solo il certificato e il profilo.
Per raccogliere l'UDID di un tester da Windows o Linux, chiedi di aprire Impostazioni, Generali, Info sull'iPhone e leggere il campo, oppure usa un helper web per l'UDID. Aggiungi il dispositivo nel portale Apple e rigenera il profilo.
Itera senza un nuovo build: Live Updates
Una volta installato il build di TestFlight, non rifare il build per ogni modifica. Spingi il web bundle invece:
bun run build
bunx @capgo/cli@latest bundle upload --channel beta
I tester sul beta canale ricevono il nuovo bundle al prossimo avvio. Per un team su Windows o Linux, questo trasforma il ciclo di feedback iOS da "attesa di un cloud build e dell'elaborazione Apple" a "secondi". I rebuild nativi sono necessari solo quando cambiano un plugin, un permesso o la versione di Capacitor.
Punta la build di TestFlight a un canale dedicato in modo che i beta tester non scarichino mai i bundle di produzione. Il guida ai canali spiega la configurazione.
Debug di iOS senza Safari Web Inspector
L'ispettore di Safari si allega solo da macOS. Alternative che funzionano da qualsiasi OS:
- Logging strutturato verso un sink remoto. Invia
console.errore inoltra gli errori a Sentry o a uno strumento simile. Il Guida a Firebase Crashlytics per Capacitor descrive la configurazione nativa di SDK. - Pannello di debug in-app. Mostra le ultime N righe di log in una view nascosta attivata da un gesto. Semplice ed efficace sulle build TestFlight.
- Log di build. I problemi di compilazione nativa compaiono nel log di build di Capgo trasmesso al terminale. Aggiungi
--ai-analyticscosì una build fallita viene spiegata automaticamente. - Riproduci su Android. Per tutto ciò che riguarda il web layer condiviso, Chrome DevTools su Android offre il debugger completo.
Per un vero crash nativo che richiede il debugger di Xcode, noleggia un Mac per un'ora o chiedi a un collega. È un caso raro in un'app Capacitor; la maggior parte dei problemi sta nel web layer o nella configurazione dei plugin.
Un workflow settimanale realistico
- Giornaliero: browser e dispositivo Android da Windows o Linux. Live Updates per il
betacanale per i tester iPhone. - Quando arrivano modifiche native: una Capgo Build su TestFlight. Pochi minuti di attesa, senza Mac.
- Rilascio: Capgo Build con distribuzione App Store, poi promuovi il canale bundle.
Riassunto
Non puoi simulare iOS su Windows o Linux, ma puoi testarlo su un iPhone senza un Mac. Capgo Build porta l'app firmata su TestFlight o a un link ad hoc con un solo comando, e Live Updates mantiene l'iterazione veloce una volta installata. Riserva il Mac per le rare sessioni di debug nativo.