Recarga en caliente en dispositivo real, módulos nativos y ciclos rápidos de iteración sin pasar por App Store o Play Store.
Etiquetas: expo, reactnative, mobile, eas, devops Compatibilidad: Expo SDK 53, Expo Router, EAS Build y Submit
Por qué usar un build de desarrollo Un build de desarrollo es tu propio Expo Go personalizado. Incluye los plugins y permisos nativos de tu app para probar en un dispositivo real con recarga en caliente. Se instala una vez y después iteras rápido con el comando npx expo start --dev-client.
Resumen rápido tras la primera vez 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 deja que el hot reload haga su trabajo. Solo recompila si cambias algo nativo como plugins, permisos o la versión del SDK.
Requisitos previos Node y npm o yarn instalados. Sesión iniciada 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 el modo túnel. En iOS se recomienda iOS 16 o superior y activar Modo desarrollador en Ajustes Privacidad y seguridad. En Android activa Opciones de desarrollador y Depuración por USB si instalarás por ADB.
Paso 1 añadir un perfil de desarrollo Edita el archivo eas.json y crea un perfil llamado development con la opción developmentClient en true y distribution en internal. En iOS puedes usar resourceClass m-medium. Mantén un perfil preview con distribution internal y uno production con autoIncrement version. En submit deja un perfil production básico. Esto le indica a EAS que genere un cliente de desarrollo que incluye tus módulos nativos.
Paso 2 compilar e instalar el cliente de desarrollo iOS Ejecuta eas build -p ios --profile development. La primera vez EAS te guiará para registrar el dispositivo mediante su UDID. Deja que EAS gestione certificados y perfiles. Cuando termine, abre la página del build e instala en el iPhone. Si se solicita, confía en el desarrollador y asegúrate de tener el Modo desarrollador activado.
Paso 2 compilar e instalar el cliente de desarrollo Android Ejecuta eas build -p android --profile development. Obtendrás un APK salvo que configures AAB. Instala desde la página del build escaneando el QR de instalación o por USB con adb install tu-app.apk tras autorizar la depuración.
Paso 3 día a día desde tu teléfono Ejecuta npx expo start --dev-client. Abre el cliente de desarrollo en tu dispositivo y escanea el QR del terminal o la interfaz web. Edita tu código, guarda y observa la actualización al instante. Solo recompila si cambias elementos nativos como plugins, permisos, capacidades de la plataforma o si actualizas Expo SDK o React Native.
Atajos útiles iOS inalámbrico Primera vez compila con eas build -p ios --profile development. En el día a día ejecuta npx expo start --dev-client y abre el cliente en el iPhone para escanear el QR.
Atajos útiles Android inalámbrico o USB Primera vez compila con eas build -p android --profile development. Cada 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 del dispositivo a tu equipo.
Uso con Expo Router Los dev clients funcionan de maravilla con Expo Router. Cambios en rutas, pantallas, enlaces y layouts se recargan al instante. Solo los cambios nativos requieren recompilación.
Solución de problemas conexión atascada en Connecting Verifica que ordenador y teléfono estén en la misma red. Prueba el túnel con npx expo start --tunnel para evitar problemas de red. Cierra otros servidores que usen el puerto 8081.
Solución de problemas iOS no instala Asegúrate de registrar el iPhone en tu equipo de Apple y vuelve a compilar tras el registro. Activa Modo desarrollador y confía en el certificado de desarrollador. Si desinstalaste la app, vuelve a instalar desde la página de EAS.
Solución de problemas cambios no visibles Agita el dispositivo y toca en Reload dentro del cliente. Limpia cache borrando la carpeta .expo y ejecuta npx expo start -c.
Duda rápida sobre recompilar Si solo cambiaste código JS o TS o rutas de Router no necesitas recompilar. Si añadiste o cambiaste un plugin, un permiso o la versión del SDK entonces sí debes recompilar.
Bonus actualizaciones OTA al instante para preview o producción No es necesario para dev clients, pero útil para testers internos o producción. Mantén un perfil preview o production en eas.json. Asegúrate de que expo-updates esté configurado en tu app config en SDK 53 ya viene por defecto. Para publicar un update usa eas update --branch preview --message Mensaje descriptivo. Si quieres que la app aplique la actualización nada más abrir, configura updates con enabled true, checkOnLaunch ALWAYS y fallbackToCacheTimeout 0 en tu config.
Preguntas frecuentes Puedo usar las tiendas para desarrollo No, los dev clients se instalan con distribución interna de EAS para iterar rápido sin tiendas. Pueden mis compañeros usar mi build de desarrollo Sí, añade sus dispositivos a tu equipo de Apple en iOS o comparte el APK o QR en Android. Ellos escanearán tu QR de Metro cuando ejecutes npx expo start --dev-client. Cómo depuro problemas nativos En iOS abre el proyecto nativo en Xcode tras ejecutar npx expo prebuild o si usas bare workflow. En Android usa Android Studio y Logcat. Para JS usa React DevTools, consola o Flipper.
Lista final de verificación eas.json incluye un perfil development con developmentClient en true. Has compilado e instalado el dev client en cada dispositivo al menos una vez. Tienes npx expo start --dev-client corriendo en tu equipo. El teléfono y el ordenador están en la misma red o usas el modo túnel. Solo recompilas cuando cambias configuración nativa.
En Q2BSTUDIO impulsamos tus proyectos móviles con procesos de entrega continua, automatización y arquitectura moderna. Somos una empresa de desarrollo de software especializada en aplicaciones a medida y software a medida, además de inteligencia artificial, ciberseguridad, servicios cloud en AWS y Azure, inteligencia de negocio con Power BI, agentes IA e IA para empresas. Si buscas acelerar tu time to market con una base sólida de CI CD, arquitectura Expo y asesoría técnica, habla con nuestro equipo. Descubre cómo creamos aplicaciones a medida multiplataforma de alto rendimiento y cómo aplicamos inteligencia artificial para potenciar tu producto y la toma de decisiones.