Conceptos Básicos de EAS Build

Diez ejemplos para eas.json, perfiles de build y tu primer cloud build de iOS/Android - la base operativa para enviar binarios de Expo SDK 57 sin Xcode local ni Android Studio en cada máquina.

Requisitos previos

Comienza con una app Expo en blanco con SDK 57 fijado e EAS CLI instalado globalmente o a través de npx:

npx create-expo-app@latest EasBuildBasics --template blank-typescript@sdk-57 --yes
cd EasBuildBasics
npm install -g eas-cli@latest
eas login

Confirma la versión fija del stack antes de configurar los builds:

{
  "dependencies": {
    "expo": "~57.0.4",
    "react": "19.2.3",
    "react-native": "0.86.0"
  }
}

Herramientas: Estos ejemplos apuntan a Expo SDK 57 (expo ~57.0.4), React Native 0.86.0 y React 19.2.3. Lee Conceptos Básicos de Prebuild antes de tu primer EAS build bajo Continuous Native Generation (CNG).

Ejemplos Básicos

1. Qué hace EAS Build

EAS Build es el servicio de compilación en cloud de Expo. Para una app típica de CNG:

1. Carga tu JavaScript, app.config.ts, lockfile y modules/ (no los ios/ / android/ ignorados por git)
2. Ejecuta npx expo prebuild cuando las carpetas nativas están ausentes
3. Instala dependencias de CocoaPods y Gradle en runners de macOS / Linux
4. Firma el artefacto con credenciales de EAS Credentials
5. Devuelve un enlace de descarga de IPA, AAB/APK o simulator build

eas build:configure

• eas build:configure crea eas.json y vincula el proyecto a tu cuenta de Expo
• Xcode local es opcional - la compilación ocurre en la infraestructura de Expo
• Ve CNG en CI para ver cuándo se generan los directorios nativos vs se registran

2. Vincula el proyecto a EAS

Cada build necesita un ID de proyecto de Expo en app.config.ts:

eas init

// app.config.ts
import type { ExpoConfig } from "expo/config";
 
const config: ExpoConfig = {
  name: "EasBuildBasics",
  slug: "eas-build-basics",
  version: "1.0.0",
  ios: {
    bundleIdentifier: "com.example.easbuildbasics",
  },
  android: {
    package: "com.example.easbuildbasics",
  },
  extra: {
    eas: {
      projectId: "00000000-0000-0000-0000-000000000000", // de eas init
    },
  },
};
 
export default config;

npx expo config --type public | jq '.extra.eas.projectId'

• eas init escribe projectId - commit app.config.ts después de vincular
• Los builds sin projectId fallan temprano con un error de configuración claro
• Las apps white-label necesitan un ID de proyecto por cada listado de store - ve Perfiles de Build y Variantes

3. eas.json mínimo

eas.json es el contrato de build - los perfiles nombran conjuntos de credenciales, canales de distribución y variables de entorno:

{
  "cli": {
    "version": ">= 16.0.0",
    "appVersionSource": "remote"
  },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal"
    },
    "preview": {
      "distribution": "internal"
    },
    "production": {}
  }
}

eas build --profile preview --platform ios

• cli.version fija la CLI mínima de EAS - CI debe coincidir o superarla
• appVersionSource: "remote" permite a EAS auto-incrementar buildNumber / versionCode en perfiles de store
• Tres perfiles cubren la mayoría de equipos: development, preview, production

4. Perfil Development (Dev Client)

Los ingenieros necesitan un binario nativo con expo-dev-client embebido - no Expo Go:

npx expo install expo-dev-client

{
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "environment": "development",
      "ios": {
        "simulator": true
      },
      "android": {
        "buildType": "apk"
      }
    }
  }
}

# Binario del Simulador de iOS (sin registro de dispositivo)
eas build --profile development --platform ios
 
# APK de Android para sideload USB
eas build --profile development --platform android

• developmentClient: true compila el menú dev y módulos nativos personalizados
• Reconstruye después de actualizaciones de SDK o cambios en dependencias nativas - OTA no puede actualizar el cliente dev
• Empareja con Reglas de Lanzamiento y OTA para la alineación de versiones en tiempo de ejecución

5. Perfil Preview (Forma QA)

Los builds preview se ven como producción pero se instalan a través de distribución interna - TestFlight interno, ad hoc o enlaces APK:

{
  "build": {
    "preview": {
      "distribution": "internal",
      "environment": "preview",
      "channel": "preview",
      "ios": {
        "simulator": false
      },
      "android": {
        "buildType": "apk"
      }
    }
  }
}

eas build --profile preview --platform all

• distribution": "internal" omite el lanzamiento público de la store - ve Distribución Interna
• channel vincula el binario a paquetes de EAS Update publicados con eas update --channel preview
• Usa preview para push, enlaces universales y QA de cámara en dispositivos físicos

6. Perfil Production (Forma Store)

Production compila binarios de lanzamiento firmados para App Store Connect y Google Play:

{
  "build": {
    "production": {
      "distribution": "store",
      "environment": "production",
      "channel": "production",
      "autoIncrement": true,
      "android": {
        "buildType": "app-bundle"
      }
    }
  }
}

eas build --profile production --platform all --non-interactive

• distribution": "store" produce artefactos listos para App Store / Play
• buildType": "app-bundle" es requerido para Play production - AAB no APK
• autoIncrement": true incrementa buildNumber de iOS y versionCode de Android remotamente

7. Primer Cloud Build de iOS

El primer build interactivo recorre la configuración de credenciales - acepta credenciales administradas por EAS a menos que tengas una cadena de certificados existente:

eas build --profile production --platform ios

Flujo de indicadores (primera vez):

? Generate a new Apple Distribution Certificate? › Yes
? Generar un nuevo Certificado de Distribución de Apple? › Sí
? Generate a new Apple Provisioning Profile? › Yes
? Generar un nuevo Perfil de Aprovisionamiento de Apple? › Sí
? Log in to your Apple Developer account › ...
? Inicia sesión en tu cuenta de Apple Developer › ...

Después del éxito:

eas build:list --platform ios --limit 3

• EAS almacena certs y perfiles cifrados - los compañeros de equipo ejecutan builds --non-interactive
• Profundización: Credenciales y Aprovisionamiento de iOS
• Contexto de plataforma iOS: Conceptos Básicos de iOS para Desarrolladores de RN

8. Primer Cloud Build de Android

El primer build de Android genera o carga un keystore - deja que EAS cree uno para apps greenfield:

eas build --profile production --platform android

? Generate a new Android Keystore? › Yes
? ¿Generar un nuevo Android Keystore? › Sí

Inspecciona credenciales almacenadas:

eas credentials --platform android

• Google Play espera AAB firmado con tu clave de carga - Play App Signing sostiene la clave de firma de la app
• Profundización: Keystores de Android y Firma
• Contexto de plataforma: Firma y Play App Signing

9. Monitorea Builds y Descarga Artefactos

Rastrea compilaciones en vuelo y recupera enlaces de instalación:

# Observa el último build
eas build --profile preview --platform ios --wait
 
# Lista builds recientes
eas build:list --status finished --limit 5
 
# Abre la página de build en el navegador
eas build:view

// Ejemplo de metadatos de build terminado (abreviado)
{
  "status": "FINISHED",
  "platform": "IOS",
  "artifacts": {
    "buildUrl": "https://expo.dev/artifacts/eas/....ipa"
  }
}

• Comparte buildUrl con QA para sideload de APK/IPA o instalaciones ad hoc
• Los builds fallidos registran errores de prebuild, pod install y Gradle - corrige plugins de configuración antes de reintentar
• CI usa --non-interactive y sondea eas build:list o webhooks de EAS

10. CNG: Deja que EAS Ejecute Prebuild

Las apps estándar de CNG ignoran carpetas nativas en git - EAS las regenera en cada build:

# .gitignore
ios/
android/

{
  "build": {
    "production": {
      "env": {
        "EXPO_NO_CAPABILITY_SYNC": "0"
      }
    }
  }
}

# Verificación local de cordura antes de gastar minutos de EAS
npx expo-doctor
npx expo prebuild --no-install
eas build --profile production --platform all

• Carga config + JS, no Info.plist editado manualmente - expresa cambios nativos en plugins
• Conceptos Básicos de Prebuild - lo que prebuild escribe antes de compilar
• Huella Digital y Detección de Cambios Nativos - cuándo reconstruir vs OTA

Preguntas Frecuentes

Relacionado

• Credenciales y Aprovisionamiento de iOS - certs, perfiles y credenciales administradas de EAS
• Keystores de Android y Firma - claves de carga y Play App Signing
• Perfiles de Build y Variantes - dev, preview, production, white-label
• EAS Submit - Cargas de App Store Connect y Play Console
• ../cng-prebuild/prebuild-basics/prebuild-basics.md - generando proyectos nativos desde config
• ../cng-prebuild/cng-in-ci/cng-in-ci.md - cuándo EAS genera vs registra directorios nativos
• ../ios-platform/ios-basics-for-rn-devs/ios-basics-for-rn-devs.md - conceptos de Xcode para equipos de RN
• ../android-platform/android-basics-for-rn-devs/android-basics-for-rn-devs.md - Gradle e identidad de paquete
• ../expo-rules/release-and-ota-rules/release-and-ota-rules.md - higiene de versión en tiempo de ejecución y canal

Versiones del stack: Esta página fue escrita para React 19.2.3, React Native 0.86.0 y Expo SDK 57 (expo ~57.0.4).