EAS Submit

Automatizando cargas en App Store Connect y Play Console - el libro de recetas para enviar artefactos de EAS Build a TestFlight, App Review y pistas de Google Play en Expo SDK 57.

Recipe

Tarjeta de referencia rápida - lista para copiar y pegar.

# Compilar y luego enviar el último artefacto
eas build --profile production --platform ios
eas submit --platform ios --latest
 
eas build --profile production --platform android
eas submit --platform android --latest
 
# Compilación + envío en un solo paso
eas build --profile production --platform ios --auto-submit

// eas.json
{
  "submit": {
    "production": {
      "ios": {
        "appleId": "release@example.com",
        "ascAppId": "1234567890",
        "appleTeamId": "ABCDE12345"
      },
      "android": {
        "serviceAccountKeyPath": "./secrets/play-service-account.json",
        "track": "internal"
      }
    }
  }
}

# Envío de CI no interactivo
eas submit --platform all --profile production --latest --non-interactive

Cuándo usar esto:

• QA aprobó una compilación de vista previa - promociona el artefacto de producción a las tiendas.
• CI debe cargar en TestFlight / pista interna de Play en cada fusión principal.
• Reemplazando cargas manuales de Transporter.app o arrastrar y soltar en Play Console.
• Estandarizando qué pista de Play recibe el AAB de cada perfil.

Ejemplo de Trabajo

iOS - App Store Connect

Paso 1 - Crear clave de API de App Store Connect

1. App Store Connect → Users and Access → Integrations → App Store Connect API.
2. Genera clave con rol App Manager o Admin.
3. Descarga .p8 una sola vez - guarda en bóveda de secretos del equipo.

eas credentials --platform ios
# Configura clave de API de App Store Connect para envío

Paso 2 - Configura eas.json

{
  "submit": {
    "production": {
      "ios": {
        "ascAppId": "1234567890",
        "appleTeamId": "ABCDE12345"
      }
    }
  }
}

Encuentra ascAppId en App Store Connect → App Information → Apple ID (numérico).

Paso 3 - Compilar y enviar

eas build --profile production --platform ios
eas submit --platform ios --profile production --latest

O con auto-submit:

{
  "build": {
    "production": {
      "distribution": "store",
      "autoIncrement": true
    }
  }
}

eas build --profile production --platform ios --auto-submit

• Las compilaciones enviadas aparecen en TestFlight dentro de minutos - TestFlight Distribution
• La presentación de App Review es un paso separado en App Store Connect después de la validación de TestFlight
• Las credenciales de firma provienen de iOS Credentials & Provisioning - el envío usa claves de API diferentes

Android - Google Play Console

Paso 1 - Crear cuenta de servicio

1. Google Cloud Console → crear cuenta de servicio sin funciones predeterminadas.
2. Play Console → Users and permissions → invita el email de la cuenta de servicio.
3. Concede Release to production, exclude devices, and use Play App Signing (o permisos de lanzamiento más estrechos para CI).
4. Descarga clave JSON → ./secrets/play-service-account.json (gitignored).

Paso 2 - Configura pistas de eas.json

{
  "submit": {
    "production": {
      "android": {
        "serviceAccountKeyPath": "./secrets/play-service-account.json",
        "track": "internal",
        "releaseStatus": "completed"
      }
    },
    "closed-beta": {
      "android": {
        "serviceAccountKeyPath": "./secrets/play-service-account.json",
        "track": "alpha"
      }
    }
  }
}

Paso 3 - Compilar AAB y enviar

eas build --profile production --platform android
eas submit --platform android --profile production --latest

• track": "internal" - ciclo de QA más rápido - Internal Testing Tracks
• Promociona internal - closed - open - production en la UI de Play Console
• versionCode debe superar todos los envíos anteriores - usa autoIncrement en el perfil de compilación

Perfiles de Envío y CI

# .github/workflows/release.yml (excerpt)
name: Release
on:
  push:
    tags: ["v*"]
jobs:
  submit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22 }
      - run: npm install -g eas-cli
      - run: eas submit --platform all --profile production --latest --non-interactive
        env:
          EXPO_TOKEN: ${{ secrets.EXPO_TOKEN }}

# Envía un ID de compilación específico (no solo --latest)
eas submit --platform ios --id <build-uuid>

• EXPO_TOKEN - token de máquina de expo.dev → Access tokens
• Almacena Apple .p8 y Play JSON como secretos de CI - referencias de rutas en eas.json o invalidaciones de env
• Cierra envío en huella digital sin cambios o aprobación de lanzamiento explícita

Envío de Artefacto Local

Envía IPAs o AABs compilados fuera de EAS:

eas submit --platform ios --path ./dist/ShopApp.ipa
eas submit --platform android --path ./dist/ShopApp.aab --profile production

Úsalo cuando:

• Migrando desde CI heredado que produce artefactos localmente
• Re-enviando una compilación conocida-buena después de un rechazo de solo metadatos

Errores Comunes

FAQs

Relacionado

• EAS Build Basics - produciendo artefactos con forma de tienda
• iOS Credentials & Provisioning - API keys de firma vs envío
• Android Keystores & Signing - alineación de clave de carga
• Internal Distribution - rutas internas de TestFlight y Play
• ../ios-platform/testflight-distribution/testflight-distribution.md - grupos de probadores y caducidad de compilación
• ../ios-platform/app-store-review-guidelines/app-store-review-guidelines.md - disponibilidad de revisión
• ../android-platform/internal-testing-tracks/internal-testing-tracks.md - flujo de trabajo de promoción de pista
• ../cng-prebuild/cng-in-ci/cng-in-ci.md - tuberías de compilación + envío de CI
• ../expo-rules/release-and-ota-rules/release-and-ota-rules.md - OTA después de envío a tienda

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