Beta Próximamente. Esta función aún está en desarrollo; los nombres y detalles pueden cambiar antes del lanzamiento.

Vista previa en móvil

Abre tu app en simuladores de iOS, emuladores de Android y teléfonos reales desde App Preview, con marcos de dispositivo y un código QR.

Beta Mobile preview es una función opcional de la vista previa de la app y está desactivada hasta que la activas. Añade un panel Devices junto a la página: cada simulador, emulador y teléfono en marcha o conectado, un botón que abre en cualquiera de ellos la página que estás viendo, tu app de React Native o Expo en Expo Go o en una development build, y un código QR con la dirección que puede abrir un teléfono de tu Wi-Fi.

App Preview de Ingot con el panel Devices: simuladores de iOS, un iPhone emparejado, un emulador de Android y un Pixel por USB, la tienda en un marco de Pixel y un código QR de la dirección LANApp Preview de Ingot con el panel Devices: simuladores de iOS, un iPhone emparejado, un emulador de Android y un Pixel por USB, la tienda en un marco de Pixel y un código QR de la dirección LAN
App Preview de Ingot con el panel Devices: simuladores de iOS, un iPhone emparejado, un emulador de Android y un Pixel por USB, la tienda en un marco de Pixel y un código QR de la dirección LAN

Activarla

Mobile preview se encuentra de tres maneras, como cada función opcional:

  • Una sugerencia en el chat. Cuando tu proyecto es una app de React Native, Expo, Capacitor, Ionic o Cordova, cuando hay un simulador, emulador o teléfono en marcha, o cuando preguntas por teléfonos, tabletas o diseños responsive, una tarjeta pequeña sobre el cuadro del chat ofrece Enable Mobile preview. × la oculta para siempre.
  • Ajustes › Funciones › Mobile preview. Un interruptor. Desactivarla oculta el panel Devices y los marcos de dispositivo.
  • El botón Mobile de la barra de estado y Devices en la barra de App Preview. Un clic activa Mobile preview y abre el panel Devices. Con la función activa, la barra de estado muestra cuántos dispositivos están listos ("2 devices").
La tarjeta de sugerencia de Mobile preview sobre el cuadro del chat de Ingot, con Enable Mobile preview y un botón para cerrarlaLa tarjeta de sugerencia de Mobile preview sobre el cuadro del chat de Ingot, con Enable Mobile preview y un botón para cerrarla
La tarjeta de sugerencia de Mobile preview sobre el cuadro del chat de Ingot, con Enable Mobile preview y un botón para cerrarla
Ajustes de Ingot, página Features: Suggest features in chat, Arena mode y el interruptor Mobile previewAjustes de Ingot, página Features: Suggest features in chat, Arena mode y el interruptor Mobile preview
Ajustes de Ingot, página Features: Suggest features in chat, Arena mode y el interruptor Mobile preview

El panel Devices

El panel muestra lo que está en marcha, agrupado, y se actualiza cada pocos segundos mientras está abierto:

GrupoSe encuentra conQué aparece
iOS Simulatorsxcrun simctl list devicesSimuladores de iPhone y iPad arrancados, con su versión de iOS
iPhone and iPadxcrun devicectl list devices (Xcode 15 o posterior)Teléfonos y tabletas emparejados con este Mac, por USB o por la red
Android Emulatorsadb devices -lEmuladores en marcha
Android devicesadb devices -lTeléfonos y tabletas por USB o Wi-Fi; los no autorizados o sin conexión aparecen atenuados
  • Haz clic en un dispositivo para ver la página a su tamaño: App Preview cambia al tamaño más parecido (iPhone SE, iPhone 15 Pro, Pro Max, Pixel 8, Galaxy S23, iPad mini o iPad Pro) y dibuja su marco.
  • Open envía la página que estás viendo a ese dispositivo.
  • App abre tu app de React Native o Expo (ver React Native y Expo).
  • Refresh vuelve a buscar ahora. Una línea bajo la lista dice qué pasó, por ejemplo "Opened on iPhone 15 Pro (Simulator)".

Qué abre cada dispositivo

App Preview muestra localhost, que solo alcanza este equipo. Ingot da a cada dispositivo una dirección que puede abrir:

DispositivoDirecciónCómo se abre
Simulador de iOSlocalhost, tal cual (el simulador comparte la red de este Mac)xcrun simctl openurl
Emulador de Android10.0.2.2, el nombre de este equipo para el emuladoradb shell am start -a android.intent.action.VIEW
iPhone o iPadLa dirección LAN de este equipo, en Safarixcrun devicectl device process launch --payload-url
Teléfono o tableta AndroidLa dirección LAN de este equipo, en el navegador predeterminadoadb shell am start -a android.intent.action.VIEW

Los dispositivos reales deben estar en la misma Wi-Fi que tu equipo y tu servidor de desarrollo debe escuchar en todas las direcciones, no solo en localhost. Si solo escucha en localhost, el panel lo indica. Con Vite ejecuta npm run dev -- --host; con Next.js next dev -H 0.0.0.0.

Android por Wi-Fi

Activa Opciones de desarrollador › Depuración inalámbrica en el teléfono, escribe su dirección en Android over Wi-Fi (por ejemplo 192.168.1.40:5555; el puerto 5555 si no lo pones) y pulsa Connect. Ingot ejecuta adb connect y el teléfono aparece en la lista. Connect Android Phone over Wi-Fi… en Find Action hace lo mismo.

Código QR para tu teléfono

Real phone, al final del panel, muestra un código QR con la dirección LAN de la página. Escanéalo con la cámara del teléfono para abrirla allí. La dirección aparece bajo el código con un botón para copiarla. El código siempre es oscuro sobre claro, en cualquier tema, para que las cámaras lo lean.

Ingot usa la dirección IPv4 de tu Wi-Fi o Ethernet. Si no es la correcta (una VPN, varias redes), configura Ajustes › Herramientas › Mobile preview › LAN address.

React Native y Expo

Cuando tu proyecto usa React Native o Expo y Metro está en marcha (en el puerto 8081 o en cualquier puerto local cuyo /status responda packager-status:running), el panel muestra Metro on :8081 · Expo · opens in Expo Go y cada dispositivo tiene un botón App:

ProyectoLa app se abre enDirección
ExpoExpo Goexp://<host>:<puerto>
Expo con expo-dev-client y un scheme en app.jsonTu development build<scheme>://expo-development-client/?url=…
React Native sin ExpoLa app instalada (bundle id de app.json o del proyecto de Xcode, paquete de android/app/build.gradle)En Android primero se hace adb reverse para que la app encuentre Metro en localhost

Los simuladores usan localhost, el emulador de Android 10.0.2.2 y los teléfonos la dirección LAN. Con Metro en marcha, Web y Expo Go (o Dev build) sobre el código QR cambian entre la dirección de la página y la de la app, así un teléfono con Expo Go entra directo en tu app.

El panel Devices con Metro encontrado: botones App y Open en cada dispositivo y el código QR en Expo Go con su dirección exp://El panel Devices con Metro encontrado: botones App y Open en cada dispositivo y el código QR en Expo Go con su dirección exp://
El panel Devices con Metro encontrado: botones App y Open en cada dispositivo y el código QR en Expo Go con su dirección exp://

Marcos de dispositivo

Con Mobile preview activa, los tamaños de teléfono y tableta de App Preview tienen un marco: un iPhone con su isla, un iPhone SE con botón de inicio, un Pixel con cámara perforada o una tableta. Al girar, el marco gira. El botón de marco junto a Devices los muestra u oculta, y Ajustes › Herramientas › Mobile preview › Device frames guarda tu elección. Los tamaños de escritorio y Responsive nunca tienen marco.

Si falta Xcode o adb

El panel muestra lo que no encontró y cómo instalarlo, y sigue funcionando con lo que hay:

FaltamacOSWindows y Linux
Simuladores de iOSInstala Xcode desde la App Store, ábrelo una vez y ejecuta sudo xcode-select -s /Applications/Xcode.appLos simuladores de iOS necesitan un Mac con Xcode
iPhone y iPadXcode 15 o posterior, con el teléfono emparejado en Xcode › Window › Devices and SimulatorsUn Mac con Xcode
Android (adb)Instala Android Studio (incluye adb) o brew install --cask android-platform-toolsInstala Android Studio o Android SDK Platform-Tools

Ingot busca adb en tu PATH, en ANDROID_HOME o ANDROID_SDK_ROOT, en la carpeta del SDK de Android Studio y en Homebrew. Para usar otra copia, pon su ruta completa en INGOT_ADB_BIN (o INGOT_XCRUN_BIN) antes de abrir Ingot.

El panel Devices sin Xcode ni adb: ningún dispositivo y los pasos para instalar iOS Simulators, iPhone and iPad y AndroidEl panel Devices sin Xcode ni adb: ningún dispositivo y los pasos para instalar iOS Simulators, iPhone and iPad y Android
El panel Devices sin Xcode ni adb: ningún dispositivo y los pasos para instalar iOS Simulators, iPhone and iPad y Android

Atajos de teclado

AcciónmacOSWindows / Linux
Mobile Preview: Open Devices⌘⌥⇧HomeCtrl+Alt+Shift+Home
Mobile Preview: Turn On or Off⌘⌥⇧MCtrl+Alt+Shift+M
Open App on Device…⌘⌥OCtrl+Alt+O
Show QR Code for Phone⌘⌥QCtrl+Alt+Q
Connect Android Phone over Wi-Fi…⌘⌥⇧ACtrl+Alt+Shift+A
Refresh Devices⌘⌥⇧RCtrl+Alt+Shift+R
Toggle Device Frames⌘⌥FCtrl+Alt+F

Todos los atajos salvo Open Devices funcionan cuando App Preview tiene el foco. Todos están en Find Action y en los ajustes del mapa de teclas.

Ajustes

AjusteValor predeterminadoQué hace
ingot.appPreview.mobile.enabledfalseMobile preview (Ajustes › Funciones): el panel Devices, los marcos y el número de dispositivos en la barra de estado
ingot.appPreview.mobile.deviceFramestrueDevice frames: un marco de iPhone, iPhone SE, Pixel o tableta alrededor de los tamaños de teléfono y tableta
ingot.appPreview.mobile.refreshInterval3Refresh devices every (seconds): cada cuánto busca el panel Devices abierto, de 1 a 60
ingot.appPreview.mobile.lanAddressvacíoLAN address: la dirección con la que los teléfonos llegan a este equipo, para dispositivos reales y el código QR; vacío usa la IPv4 de Wi-Fi o Ethernet
ingot.suggestions.enabledtrueSuggest features in chat: las tarjetas que sugieren funciones opcionales
ingot.suggestions.dismissed[]Suggestions you closed: mobile-preview se añade al cerrar su tarjeta con ×

Privacidad

Todo se ejecuta en tu equipo: Ingot llama a xcrun y adb en local y solo lee sus listas de dispositivos. No se envía nada sobre tus dispositivos ni tu app, y el código QR solo contiene la dirección local de tu servidor de desarrollo.

Desde la terminal

ingot preview mobile lista los mismos dispositivos, ingot preview mobile open envía un servidor de desarrollo a uno e ingot preview qr imprime el código QR en la terminal:

ingot preview mobile                            # dispositivos por grupo, Metro y lo que falta; --json
ingot preview mobile open "iPhone 15 Pro" 5173  # un dispositivo por id o nombre, un puerto o URL
ingot preview mobile open emulator-5554 --app   # la app de Expo / React Native
ingot preview mobile connect 192.168.1.40       # adb por Wi-Fi
ingot preview qr 5173                           # QR de la dirección LAN; --expo para Expo Go, --invert

Todas las opciones están en CLI.