Probar iOS desde Windows o Linux se resume en un hecho: el iOS Simulator y Safari Web Inspector solo están disponibles en macOS. Todo lo demás se puede resolver. Esta guía propone una secuencia de pruebas que funciona sin Mac, desde el navegador hasta un iPhone real, y muestra dónde Build de Capgo y Live Updates elimina la espera.
La escalera de testing
| Nivel | Qué pruebas | Dónde se ejecuta | Requiere Mac |
|---|---|---|---|
| 1 | Capa web: lógica, layout y diseño responsive | Navegador de escritorio con viewport de iPhone | No |
| 2 | Plugins Capacitor, bridge nativo y permisos | Emulador o dispositivo Android | No |
| 3 | Comportamiento real de iOS: peculiaridades de WebKit, safe areas, teclado, push, plugins de iOS | iPhone vía TestFlight | No, con Capgo Build |
| 4 | Builds QA ad hoc para dispositivos específicos | iPhone vía IPA Ad Hoc | No, con Capgo Build |
| 5 | Depuración nativa paso a paso en Xcode | Mac | Sí |
La mayoría de los bugs se detectan en los niveles 1 y 2. El nivel 3 detecta los que solo pasan en iOS. El nivel 5 es raro en una app de Capacitor, y cuando ocurre, alquilar un Mac por una hora sale más barato que tener uno.
Nivel 1: el navegador con viewport de iPhone
Abre tu servidor de desarrollo en Chrome o Edge, activa la emulación de dispositivos y elige un perfil de iPhone. Capacitor expone información de la plataforma para que puedas ramificar la UI:
import { Capacitor } from '@capacitor/core';
if (Capacitor.getPlatform() === 'ios') {
// iOS-only behavior
}
Lo que no detecta: diferencias de renderizado en WebKit, safe area insets, el teclado de iOS que desplaza el viewport y todo lo que interactúe con un plugin nativo.
Nivel 2: Android primero, porque la capa web es compartida
Capacitor ejecuta el mismo web bundle en ambas plataformas. La conexión de plugins, los prompts de permisos y las llamadas al bridge se pueden validar en Android desde Windows o Linux con Chrome DevTools en chrome://inspect. Si una llamada a un plugin funciona en Android, el lado de JavaScript está bien; lo que queda es la implementación nativa de iOS, que se prueba en el nivel 3.
Guías de configuración: Windows y Linux.
Nivel 3: un iPhone real mediante TestFlight
Esta es la ruta principal de pruebas en iOS sin un Mac. Flujo:
- Genera y sincroniza el proyecto iOS en local.
- Solicita un cloud build con las credenciales de App Store Connect guardadas.
- Abre TestFlight en el iPhone.
bun run build
bunx cap sync ios
bunx @capgo/cli@latest build request com.example.app --platform ios --build-mode release
Capgo compila y firma la app en macOS y luego la sube a App Store Connect. Apple procesa el build y TestFlight lo muestra a los testers internos en minutos. Los testers internos (miembros de tu equipo de App Store Connect) no necesitan Beta App Review, así que la primera instalación es rápida.
La configuración de credenciales se hace una sola vez; bunx @capgo/cli@latest build init --platform ios lo guía, y el certificado se puede crear sin un Mac usando OpenSSL o el generador de certificados iOS.
Lo que obtienes en el dispositivo: WebKit real, safe areas reales, el teclado real, push notifications reales, el comportamiento real de los plugins. Esa es la lista de cosas que el navegador no podía decirte.
Nivel 4: builds ad hoc para dispositivos específicos
Cuando un tester está fuera de tu equipo de App Store Connect, o quieres saltarte el procesamiento de Apple, usa un perfil Ad Hoc que liste el UDID del dispositivo:
bunx @capgo/cli@latest build request com.example.app \
--platform ios \
--ios-distribution ad_hoc \
--output-upload \
--output-record build.json
CLI devuelve un enlace de descarga temporal y un código QR code para el IPA. La retención se puede configurar de 1 hora a 7 días con --output-retention. Los perfiles ad hoc no necesitan una clave API de App Store Connect, solo el certificado y el perfil.
Para obtener el UDID de un tester desde Windows o Linux, pídele que abra Ajustes > General > Información en el iPhone y lea el campo, o usa un helper web de UDID. Añade el dispositivo en el portal de Apple y regenera el perfil.
Iterar sin un nuevo build: Live Updates
Una vez instalada la build de TestFlight, no reconstruyas para cada cambio. En su lugar, sube el web bundle:
bun run build
bunx @capgo/cli@latest bundle upload --channel beta
Los testers en beta el canal recibe el nuevo bundle en el próximo inicio. Para un equipo en Windows o Linux, esto convierte el ciclo de feedback de iOS de «esperar un build en la nube y el procesamiento de Apple» en «segundos». Las recompilaciones nativas solo son necesarias cuando cambia un plugin, un permiso o la versión de Capacitor.
Dirige tu build de TestFlight a un canal dedicado para que los beta testers nunca descarguen bundles de producción. La guía de canales explica la configuración.
Debuggear iOS sin Safari Web Inspector
El inspector de Safari solo se puede conectar desde macOS. Alternativas que funcionan en cualquier SO:
- Logging estructurado hacia un sink remoto. Enviar
console.errory envía los errores a Sentry o a una herramienta similar. El Guía de Firebase Crashlytics para Capacitor cubre la configuración nativa de SDK. - Panel de debug en la app. Renderiza las últimas N líneas de logs en una vista oculta activada por un gesto. Barato y efectivo para builds de TestFlight.
- Logs de build. Los problemas de compilación nativa aparecen en el log de build de Capgo que se transmite a tu terminal. Añade
--ai-analyticspara que un build fallido se explique automáticamente. - Reproducir en Android. Para cualquier cosa en la capa web compartida, Chrome DevTools en Android ofrece el debugger completo.
Para un crash nativo real que requiera el debugger de Xcode, alquila un Mac una hora o pide ayuda a un compañero. Ese caso es raro en una app Capacitor; la mayoría de los problemas están en la capa web o en la configuración de plugins.
Un workflow semanal realista
- Diario: navegador más dispositivo Android desde Windows o Linux. Live Updates para
betacanal para probadores de iPhone. - Cuando llegan cambios nativos: una Capgo Build a TestFlight. Unos minutos de espera, sin Mac.
- Lanzamiento: Capgo Build con distribución en App Store, luego promueve el canal del bundle.
Resumen
No puedes simular iOS en Windows o Linux, pero sí probarlo en un iPhone sin un Mac. Capgo Build envía la app firmada a TestFlight o a un enlace ad hoc con un solo comando, y Live Updates mantiene la iteración rápida una vez instalada. Guarda el Mac para las raras sesiones de depuración nativa.