Clase 05 · Módulo 03
Tu primer development build con EAS
Tu primer development build con EAS
Qué logras en esta clase
Terminas con tu app instalada en tu teléfono y conectada a tu computador.
- Creas tu cuenta de Expo e instalas EAS CLI.
- Entiendes los perfiles de
eas.json. - Compilas en la nube para Android o iPhone.
- Instalas el build y lo conectas al servidor de desarrollo.
02
La primera vez que tu app es una app
Hasta ahora tenías una carpeta con código. Al terminar esta clase tendrás un ícono en tu teléfono que abre tu proyecto.
03
Qué es EAS
EAS, sigla de Expo Application Services, es el conjunto de servicios en la nube de Expo. El que usas hoy compila tu app en sus máquinas y te devuelve un archivo instalable.
Se maneja con EAS CLI, un programa de terminal cuyo comando es eas.
04
Compilar en la nube o en tu computador
| En la nube (EAS) | Local | |
|---|---|---|
| Qué necesitas instalar | Nada más | Android Studio, o Xcode en un Mac |
| Cuenta de Expo | Sí | No |
| Gasta cupo mensual | Sí | No |
| iOS desde Windows | Sí | No |
El camino local usa npx expo run:android. En esta clase se usa la nube: es el único que sirve para todos los sistemas y para iPhone sin Mac.
05
Lo que necesitas antes de empezar
- El proyecto creado y sin errores en
npx expo-doctor@latest. - Los identificadores definitivos en
app.json. - Una cuenta de Expo, gratis, creada en expo.dev.
- Un teléfono Android, o un iPhone con los requisitos que verás más abajo.
Si vas a hacer los dos, parte por Android: no exige ninguna cuenta de pago y te deja aprender el proceso completo.
06
Paso 1: EAS CLI y sesión
npm install --global eas-cli
eas login
eas whoamiEl primero instala la herramienta. El segundo inicia sesión con tu cuenta de Expo. El tercero confirma con qué usuario quedaste.
07
Paso 2: sumar las herramientas de desarrollo
En la carpeta del proyecto, ejecuta npx expo install expo-dev-client.
Ese paquete convierte un build común en un development build:
- Agrega la pantalla para conectarse a tu computador.
- Agrega el menú de desarrollo.
Tiene código nativo, así que se instala antes de compilar. Si lo sumas después, toca compilar de nuevo.
08
Paso 3: el archivo eas.json
eas build:configureEste comando deja el proyecto configurado para compilar. La configuración vive en eas.json, el archivo que describe cómo se construye tu app. Si no existe al lanzar el primer build, EAS CLI ofrece crearlo con un perfil development.
El archivo se sube a Git: es parte del proyecto, no un secreto.
09
Los tres perfiles
Un perfil es una receta de compilación con nombre.
| Perfil | Para qué | Quién lo instala |
|---|---|---|
development | Desarrollar, con herramientas incluidas | Tú |
preview | Mostrar la app sin herramientas | Tus testers |
production | Enviar a las tiendas | Usuarios finales |
Hoy usas solo el primero. Abre tu eas.json y pide a Claude que te explique cada campo que trae.
10
Qué significa distribución interna
Un perfil con "distribution": "internal" produce una app que se instala directo desde un enlace, sin pasar por la tienda.
11
Android: lanzar el build
eas build --platform android --profile development- EAS CLI revisa el proyecto y hace algunas preguntas.
- Cuando pregunte por la firma, acepta generar un keystore nuevo.
- El proyecto se sube y entra a la cola.
- La terminal muestra un enlace a la página del build.
El keystore es el archivo que firma tu app en Android. EAS lo crea y lo guarda en sus servidores.
12
Qué pasa mientras esperas
- En el plan gratuito la cola es de prioridad baja y cada build puede durar hasta 45 minutos.
- La terminal espera el resultado, pero puedes interrumpir la espera: el build sigue en la nube.
- El estado se ve en expo.dev/builds o con
eas build:list.
13
Instalar en Android
- Al terminar, la terminal muestra un código QR.
- Escanéalo con la cámara del teléfono.
- Descarga el archivo APK, el formato instalable de Android.
- Acepta el aviso de seguridad sobre apps que no vienen de Play Store.
- Abre la app instalada.
También puedes abrir la página del build en el teléfono y usar el botón «Install».
14
iPhone: tres requisitos previos
| Requisito | Por qué |
|---|---|
| Cuenta de Apple Developer de pago | Apple exige firmar todo build que corra en un iPhone |
| Dispositivo registrado | El build solo se instala en los iPhone de su lista |
| Modo de desarrollador activado | El iPhone lo exige para abrir builds de desarrollo |
El modo de desarrollador se activa en los ajustes del iPhone. La guía de Expo para crear un development build, citada en las fuentes, enlaza los pasos.
15
iPhone: registrar el dispositivo y compilar
eas device:create
eas build --platform ios --profile development- El primer comando genera un enlace o código QR: ábrelo en el iPhone y sigue los pasos.
- El segundo lanza el build.
- Cuando lo pida, inicia sesión con tu cuenta de Apple Developer.
- EAS crea el certificado y el perfil que firman la app.
- Al terminar, abre el enlace del build en el iPhone e instala.
16
Límites del camino iPhone
- Solo los iPhone registrados antes de compilar pueden instalar ese build.
- Para sumar otro dispositivo: un build nuevo, o volver a firmar el existente con
eas build:resign. - Apple permite hasta 100 iPhone por año con este método.
17
Todo esto funciona desde Windows
El build de iOS se compila en máquinas macOS de la nube de Expo. Tu computador solo sube el proyecto y recibe un enlace.
Lo que no tendrás sin Mac es el simulador de iOS. Por eso, desde Windows, el iPhone físico es tu única forma de ver la versión de iOS. Lo viste en el módulo 1, clase 5.
18
Conectar el build con tu computador
- En la terminal del proyecto, ejecuta
npx expo start. - Abre la app instalada en el teléfono.
- En su pantalla inicial, elige el servidor de tu computador o escanea el QR.
- Cambia un texto en el código y guarda.
Si el texto cambia en el teléfono sin tocar nada, el ciclo de desarrollo quedó armado.
19
Si el teléfono no encuentra el servidor
Por defecto la conexión va por la red local: teléfono y computador deben estar en el mismo wifi.
| Causa probable | Qué probar |
|---|---|
| Redes distintas | Conecta ambos al mismo wifi |
| Wifi restrictivo o cortafuegos | Modo túnel |
El modo túnel se inicia con npx expo start --tunnel y requiere instalar antes el paquete @expo/ngrok. Es más lento y depende de un servicio externo: úsalo solo si la red local falla.
20
Compilas cuando cambia lo nativo
Un build no es un guardado. Compilas cuando cambia lo nativo; todo lo demás llega solo al teléfono.
21
Cuidar el cupo gratuito
| Plan Free de EAS al 18-11-2026 | Límite |
|---|---|
| Builds de Android | 15 al mes |
| Builds de iOS | 15 al mes |
| Duración máxima por build | 45 minutos |
Al agotarse no hay cobro extra: esperas al mes siguiente o pasas al plan Starter, de 19 USD al mes más uso.
22
Si el build falla
- Abre la página del build y busca la etapa marcada con error.
- Copia el texto del error completo, no solo la última línea.
- Pégalo en Claude Code junto con qué cambiaste desde el último build bueno.
- Corrige, ejecuta
npx expo-doctor@latesty recién entonces compila de nuevo.
23
Errores comunes
- Compilar para iPhone sin registrar el dispositivo. El build termina bien y no se instala.
- Olvidar
expo-dev-client. Sale una app que no se conecta al servidor. - Cambiar los identificadores después del primer build. El teléfono lo trata como otra app.
- Borrar el keystore o crear otro sin motivo. Deja que EAS administre las credenciales.
24
Lo que te llevas
- EAS compila en la nube;
eas.jsondefine los perfilesdevelopment,previewyproduction. - Android no exige cuentas de pago; iPhone exige cuenta de Apple, dispositivo registrado y modo de desarrollador.
- El build se instala desde un enlace y se conecta con
npx expo start. - El cupo gratuito es de 15 builds por plataforma al mes.
- Ante un fallo, se lee el error antes de recompilar.
25
Hazlo ahora
En 15 minutos de trabajo, más la espera del build:
- Crea tu cuenta de Expo e instala EAS CLI.
- Instala
expo-dev-clienty ejecutaeas build:configure. - Lanza el build de desarrollo para tu teléfono.
- Mientras compila, lee tu
eas.jsoncon Claude. - Instala la app, conéctala y cambia un texto para ver la recarga.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026