Pistas de prueba interna

Pistas de prueba cerradas y abiertas en Google Play - la guía para enviar compilaciones de Expo SDK 57 Android a probadores reales antes de que los usuarios de producción vean regresiones. Las pistas son canales de distribución de Play Console; EAS Submit envía AABs firmados a ellas.

Receta

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

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

# Construir AAB de lanzamiento
eas build --platform android --profile production
 
# Enviar a pruebas internas (bucle de retroalimentación más rápido)
eas submit --platform android --profile production --latest
 
# Promover en la interfaz de usuario de Play Console: interno - cerrado - abierto - producción
# O enviar directamente a alpha/beta con perfil eas.json coincidente
eas submit --platform android --profile closed-beta --latest

// app.config.ts - versionCode monótono (requerido en cada carga)
export default {
  expo: {
    version: "2.4.0",
    android: {
      package: "com.example.shopapp",
      versionCode: 240012, // incrementar en cada carga a Play
    },
  },
};

Cuándo usarlo:

• Primer lanzamiento en Play Store - la pista interna valida la firma, seguridad de datos y clasificación de contenido antes de producción.
• QA necesita una compilación entregada por Play (no solo el enlace EAS APK interno) para probar compras dentro de la aplicación y App Links.
• Quieres 500 probadores beta en la pista cerrada antes de un lanzamiento de producción escalonado del 5%.
• Rechazo de política - soluciona en interno, reenvía sin tocar a los usuarios de producción.

Ejemplo de trabajo

Paso 1 - Crear aplicación de Play y completar lo básico de la lista de tiendas

1. Play Console - Crear aplicación.
2. Termina las tareas requeridas del Panel de control: política de privacidad, seguridad de datos, clasificación de contenido, audiencia de destino.
3. Habilita Play App Signing en la primera carga.

Paso 2 - Cuenta de servicio para EAS Submit

# Play Console - Usuarios y permisos - Invitar usuario - Cuenta de servicio
# Google Cloud - IAM - Crear clave JSON - guardar como secrets/play-service-account.json
# Otorgar Administrador de lanzamiento (o mínimo: Lanzamiento a pistas de prueba)

Paso 3 - Primera carga de pista interna

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

Play Console - Pruebas - Pruebas internas - la versión aparece después del procesamiento (~minutos a horas).

Paso 4 - Agregar probadores

Comparte el enlace de opt-in de Probadores - Copiar enlace - los probadores aceptan la invitación y luego instalan desde Play Store.

Paso 5 - Promover después de la aprobación de QA

Play Console - Promover versión de interno - cerrado - producción.

O envía una nueva compilación directamente a la pista de producción con eas.json "track": "production" actualizado cuando esté listo.

Paso 6 - Verificar App Links en la compilación interna

# Después de que la versión interna esté activa en Play (re-firmada con la clave de firma de la aplicación)
adb shell pm get-app-links com.example.shopapp

Usa SHA-256 de App signing de Play en assetlinks.json - ver Android App Links.

Lo que esto demuestra:

• Pista interna - camino más rápido desde eas submit a la compilación de Play instalable.
• Cuenta de servicio - cargas no interactivas amigables con CI.
• versionCode - debe aumentar por carga en todas las pistas.
• Flujo de promoción - el mismo artefacto puede escalar pistas sin reconstrucción.

Análisis profundo

Cómo funciona

• Pistas son canales de lanzamiento de Play Console que comparten una applicationId pero diferentes audiencias de probadores.
• Procesamiento de AAB - Google genera APKs específicos del dispositivo después de la carga; los probadores descargan a través de Play Store, no cargan lateralmente.
• Mismo pipeline de firma - todas las pistas obtienen Play App Signing; las diferencias son solo visibilidad y reglas de lanzamiento.
• EAS Submit - utiliza la API del Desarrollador de Google Play (edits.insert + bundles.upload) para colocar AAB en la pista elegida.
• Revisión - Las pruebas internas a menudo omiten una revisión larga; producción y a veces pruebas abiertas desencadenan revisión de política.

Comparación de pistas

// Asignación de pistas eas.json (convención común)
// "alpha"  - Pruebas cerradas
// "beta"   - Pruebas abiertas
// "internal" - Pruebas internas

Reglas de versionado

// eas.json - incremento automático de versionCode en EAS Build
{
  "build": {
    "production": {
      "autoIncrement": true
    }
  }
}

Qué probar por pista

Bosquejo de canalización CI

# .github/workflows/android-release.yml (conceptual)
jobs:
  build-submit-internal:
    steps:
      - run: eas build --platform android --profile production --non-interactive
      - run: eas submit --platform android --profile production --latest --non-interactive

Puertas de promoción de producción en lista de verificación de QA + sesiones sin bloqueos en pista interna.

Errores comunes

• Mismo versionCode al reenviar - Play rechaza duplicados. Solución: Incrementa versionCode o habilita autoIncrement.
• Los probadores no encuentran la aplicación - Deben aceptar el enlace de opt-in con la cuenta de Google en el dispositivo. Solución: Reenvía el enlace; verifica la falta de coincidencia de cuenta.
• Probar APK de depuración en lugar de compilación de Play - IAP y App Links se comportan de manera diferente. Solución: Instala desde la pista interna de Play después de eas submit.
• Omitir seguridad de datos en interno - El panel de control puede bloquear todas las pistas hasta completarlas. Solución: Primero termina las tareas de cumplimiento.
• Beta abierta antes de validación cerrada - Reseñas de una estrella públicas en compilaciones beta. Solución: Pista cerrada con usuarios avanzados invitados primero.
• Promover compilación rota a producción - La promoción copia notas de versión, no una nueva pasada de QA. Solución: Ejecuta la lista de verificación en cada promoción de pista.

Alternativas

Preguntas frecuentes

Relacionado

• Firma y Play App Signing - clave de carga y Play App Signing
• Permisos y política de Play - seguridad de datos antes de enviar cualquier pista
• Android App Links - verificar enlaces HTTPS en compilaciones internas
• Tamaño de página de 16 KB y matriz de dispositivos - matriz de prueba antes de beta abierto
• ../eas-build/eas-submit/eas-submit.md - detalles de automatización de envío
• ../store-operations/phased-release-and-rollback/phased-release-and-rollback.md - porcentajes de lanzamiento de producción

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