Recarga en caliente en dispositivo real, módulos nativos y ciclos de iteración rápidos sin pasar por App Store ni Play Store
Tags: expo, reactnative, mobile, eas, devops. Compatible con: Expo SDK 53, Expo Router, EAS Build/Submit
Por qué usar un build de desarrollo
Un build de desarrollo es tu propio Expo Go personalizado. Incluye los plugins nativos y permisos de tu app para que pruebes todo en un dispositivo real con recarga en caliente. Lo instalas una vez y luego iteras lanzando npx expo start --dev-client
Resumen rápido una vez configurado
1 Inicia el servidor de desarrollo con npx expo start --dev-client
2 En tu teléfono abre el build de desarrollo instalado y escanea el código QR
3 Programa, guarda y disfruta del hot reload. Solo recompila si cambias algo nativo como plugins, permisos o versión del SDK
Requisitos previos
Node y npm o yarn instalados. Autenticado en Expo con npx expo login o comprueba con npx expo whoami. EAS CLI instalado con npm i -g eas-cli. Ordenador y teléfono en la misma red Wi-Fi o usa túnel
Específico para iOS
iOS 16 o superior recomendado. En Ajustes Privacidad y seguridad activa Modo desarrollador el iPhone se reinicia al activarlo
Específico para Android
Activa Opciones de desarrollador y Depuración USB si instalas por USB o ADB
Paso 1 Añade un perfil de desarrollo
En el archivo eas.json de la raíz del proyecto define una sección cli con version mayor o igual que 10.0.0. En build crea el perfil development con developmentClient true y distribution internal. Puedes ajustar ios resourceClass m-medium y android vacío o con lo que necesites. Añade también perfiles preview con distribution internal y production con autoIncrement version. En submit define production según tu flujo
developmentClient true indica a EAS que genere un cliente de desarrollo tu Expo Go personalizado con tus módulos nativos
Paso 2 Compila el cliente de desarrollo lo instalas una sola vez
iOS
Ejecuta eas build -p ios --profile development. En la primera vez EAS te guiará para registrar tu dispositivo UDID mediante QR. Deja que EAS gestione certificados y perfiles. Cuando termine abre la página del build e instala en tu iPhone. Si te lo pide confía en el desarrollador y asegúrate de que el Modo desarrollador está activado
Android
Ejecuta eas build -p android --profile development. Obtendrás un APK salvo que configures AAB. Instala escaneando el QR de la página del build o por USB con adb install archivo.apk tras autorizar la depuración
Paso 3 Uso diario en tu teléfono
Lanza npx expo start --dev-client. Abre el build de desarrollo en el teléfono el que tiene el nombre e icono de tu app. Escanea el QR que muestra la terminal o la web. Edita, guarda y verás la actualización al instante. Solo recompila cuando cambies algo nativo como plugins o módulos, permisos o capacidades de iOS o Android, o actualices la versión de Expo SDK o React Native
Atajos útiles para copiar y pegar
iOS por Wi-Fi. Primera vez compila con eas build -p ios --profile development. Cada día ejecuta npx expo start --dev-client y abre el cliente de desarrollo en el iPhone para escanear el QR
Android por Wi-Fi o USB. Una vez compila con eas build -p android --profile development. En el día a día ejecuta npx expo start --dev-client y abre el cliente en Android para escanear el QR. Si Metro no conecta por Wi-Fi puedes usar adb reverse tcp:8081 tcp:8081 para mapear el puerto al de tu máquina
¿Usas Expo Router? Sin problema
Los clientes de desarrollo funcionan de maravilla con Expo Router. Los cambios en rutas, pantallas, enlaces y layouts recargan al instante. Solo necesitas recompilar cuando haya cambios nativos
Solución de problemas
Si se queda en Conectando asegúrate de que ordenador y teléfono usan la misma red. Prueba un túnel con npx expo start --tunnel para evitar restricciones de la Wi-Fi. Cierra otros servidores que usen el puerto 8081
Si iOS no instala verifica que el iPhone esté registrado en tu equipo de Apple y recompila tras registrarlo. Activa Modo desarrollador y confía en el certificado del desarrollador. Reinstala desde la página de EAS si eliminaste la app
Si los cambios no aparecen agita el dispositivo y pulsa Recargar en el cliente de desarrollo. Limpia la caché borrando la carpeta .expo y ejecuta npx expo start -c
¿Tengo que recompilar? Si solo cambiaste código JS, TS o rutas no. Si añadiste o cambiaste un plugin, un permiso o la versión del SDK sí
Bonus actualizaciones OTA instantáneas para preview o producción
No es necesario para clientes de desarrollo, pero es útil con testers internos o en producción. Mantén un perfil preview o production en eas.json. En app.json o app.config.ts verifica que expo-updates esté configurado en SDK 53 ya viene por defecto. Para publicar un update usa eas update --branch preview --message Mensaje del cambio
Para que la app compruebe actualizaciones al iniciar configura updates con enabled true, checkOnLaunch ALWAYS y fallbackToCacheTimeout 0 en tu configuración no de desarrollo
Preguntas frecuentes
Puedo usar App Store o Play Store para desarrollo No, los builds de desarrollo se instalan con distribución interna de EAS. Justo eso permite iterar rápido sin las tiendas
Pueden mis compañeros usar mi build de desarrollo Sí. En iOS añade sus dispositivos a tu equipo de Apple y recompila tras hacerlo. En Android comparte el APK o el QR. Ellos escanearán el QR de Metro cuando ejecutes npx expo start --dev-client
Cómo depuro problemas nativos En iOS abre el proyecto nativo en Xcode generado tras npx expo prebuild o si estás en bare. En Android usa Android Studio y Logcat. Para JS usa React DevTools, logs de consola o Flipper
Checklist final
eas.json incluye un perfil development con developmentClient true. Has compilado e instalado el cliente de desarrollo en cada dispositivo solo una vez. Tienes npx expo start --dev-client corriendo en tu equipo. Teléfono y ordenador comparten red o usas --tunnel. Solo recompilas cuando cambias configuración nativa
En Q2BSTUDIO te ayudamos a acelerar estos flujos con apps móviles y backend listos para integrarse con CI, OTA y analítica. Somos una empresa de desarrollo de software especializada en aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud AWS y Azure, servicios inteligencia de negocio, ia para empresas, agentes IA y power bi. Si necesitas un equipo para construir o escalar tu app, descubre cómo abordamos proyectos de alto impacto en nuestro servicio de desarrollo de aplicaciones y software multiplataforma y cómo optimizamos despliegues y pipelines en la nube con servicios cloud en AWS y Azure
Si quieres, comparte tu iOS bundleId y Android applicationId y te preparamos un guion de comandos listo para copiar y pegar adaptado a tu proyecto. A construir se ha dicho