Distribución TestFlight

Gestión de probadores internos/externos y caducidad de compilaciones - el recetario de TestFlight para enviar IPAs de Expo SDK 57 a QA, stakeholders y usuarios beta antes del lanzamiento de App Store.

Receta

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

# Construir IPA formada para producción para TestFlight
eas build --profile production --platform ios
 
# Cargar a App Store Connect (pestaña TestFlight)
eas submit --platform ios --latest
 
# O construir + enviar en un flujo de trabajo (eas.json)
eas build --profile production --platform ios --auto-submit

// eas.json - perfil de producción para TestFlight
{
  "build": {
    "production": {
      "distribution": "store",
      "ios": {
        "simulator": false
      }
    },
    "preview": {
      "distribution": "internal",
      "ios": {
        "simulator": false
      }
    }
  },
  "submit": {
    "production": {
      "ios": {
        "appleId": "you@example.com",
        "ascAppId": "1234567890",
        "appleTeamId": "ABCDE12345"
      }
    }
  }
}

Cuándo usarlo:

• QA necesita una compilación de iOS instalable sin lanzamiento público en App Store.
• Validar enlaces universales, push, Sign in with Apple o IAP en dispositivos reales.
• Demostraciones de stakeholders en iPhones físicos fuera de tu cable USB.
• Dogfooding de un candidato de lanzamiento antes de eas submit a App Review.
• Gestionar grupos beta entre equipos de marketing, QA y ejecutivos.

Ejemplo de trabajo

Paso 1 - Configurar credenciales EAS

eas credentials --platform ios
# Certificado de distribución + perfil de provisioning de App Store para bundle ID

Asegúrate de que App Store Connect tenga un registro de app que coincida con ios.bundleIdentifier.

Paso 2 - Construir y enviar

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

App Store Connect → pestaña TestFlight → la compilación muestra Procesando (5-30 minutos) luego Listo para probar.

Paso 3 - Prueba interna (camino rápido)

1. TestFlight → Internal Testing → grupo predeterminado o crear grupo.
2. Agregar compilaciones - la última carga está disponible automáticamente para el grupo interno.
3. Los probadores instalan la aplicación TestFlight de App Store → aceptan invitación → instalan compilación.

Paso 4 - Prueba externa (beta más amplia)

1. TestFlight → External Testing → crear grupo (p. ej., Public Beta).
2. Agregar compilación → llenar notas de What to Test para revisores.
3. Enviar para revisión de Beta App - generalmente horas, no días.
4. Compartir Public Link o invitaciones por correo.

Paso 5 - Manejar expiración de 90 días

La compilación de TestFlight expira: 2026-04-08
Hoy: 2026-04-01
Acción: programar eas build esta semana; notificar probadores antes del lapso

# Reconstruir el mismo tag de git o rama de lanzamiento
eas build --profile production --platform ios
eas submit --platform ios --latest
# Grupos externos: la nueva compilación puede necesitar revisión de Beta App si hay cambios materiales

Automatizar recordatorios:

# .github/workflows/testflight-expiry-reminder.yml (conceptual)
# Analizar Connect API para compilación que expira más pronto; Slack cuando < 14 días

Lo que esto demuestra:

• El camino interno salta la revisión de Beta App - el bucle más rápido para ingeniería.
• El camino externo escala a miles con puerta de Apple.
• La expiración de 90 días es difícil - planifica reconstrucciones para maratones QA.
• El perfil de producción coincide con la firma de App Store y los permisos.

Profundizar

TestFlight vs otra distribución de iOS

Para enlaces universales y push, prefiere TestFlight (producción aps-environment) sobre clientes dev al validar comportamiento de producción.

Estados de procesamiento

Carga recibida → Procesando → Listo para probar → (Externa) Esperando revisión → Probando
                     ↓ falla
                  Binario no válido / Cumplimiento faltante

Cumplimiento faltante: Responde preguntas de cifrado en Connect - igual que App Store.

Binario no válido: A menudo manifiesto de privacidad (ITMS-91053) - arreglar antes de que los probadores vean algo.

Experiencia del probador

1. Recibir correo electrónico o enlace público.
2. Instalar aplicación TestFlight de Apple (si falta).
3. Aceptar invitación → Instalar → la app aparece en la pantalla de inicio.
4. TestFlight muestra notas de lanzamiento de What to Test que proporcionas.
5. Las actualizaciones automáticas cuando asignas compilaciones más nuevas a su grupo.

Los registros de fallos y capturas de pantalla fluyen hacia Connect → TestFlight → compilación → Crashes.

Notas de "What to Test" (plantilla)

Compilación 1.4.0 (42) - beta de marzo de 2026
 
Enfoque:
- Enlace universal: https://shop.example.com/orders/demo abre pantalla de pedido
- Push: habilitar notificaciones en el inicio de sesión; toca notificación rutas a bandeja de entrada
- Eliminación de cuenta: Configuración → Eliminar cuenta
 
Problemas conocidos:
- Recorte menor de diseño iPad en carrito - corrección programada 1.4.1
 
Credenciales: review@example.com / BetaDemo2026!

Emparejamiento con CI

# Envío CI no interactivo
EXPO_TOKEN=xxx eas build --profile production --platform ios --non-interactive
EXPO_TOKEN=xxx eas submit --platform ios --latest --non-interactive

Gate submit en expo-doctor, pruebas, y tiempo de remojo TestFlight interno antes de beta externa.

Compilaciones de simulador

"ios": { "simulator": true }

• Produce .app para Simulator - no puede subir a TestFlight.
• TestFlight requiere IPAs de dispositivo (simulator: false).

Errores comunes

• Usando developmentClient: true para TestFlight - tipo binario incorrecto para distribución de almacén. Arreglo: perfil de producción sin flag de cliente dev para pista TestFlight.
• Esperando push en sandbox con compilación de TestFlight - TestFlight usa producción APNs. Arreglo: clave de push de producción en proveedor; aps-environment correcto.
• Compilación expirada a mitad de UAT - los probadores no pueden instalar ni actualizar. Arreglo: reconstruir antes del día 90; comunicar en Slack.
• Beta externa bloqueada en primer fallo - Beta App Review rechaza compilaciones inestables. Arreglo: remojo interno primero.
• Bundle ID incorrecto en Connect - la carga se realiza correctamente en app incorrecta. Arreglo: coincide ascAppId en perfil de envío eas.json.
• Enlaces universales "funcionan en simulador" pero fallan en TestFlight - AASA / appID no coincide con bundle de producción. Arreglo: iOS Universal Links.

Alternativas

FAQs

Relacionado

• App Store Review Guidelines - qué pantallas Beta App Review
• EAS Submit - automatización de carga
• Internal Distribution - alternativa ad hoc
• iOS Credentials & Provisioning - configuración de firma
• Physical Device Testing - USB antes de TestFlight
• iOS Universal Links - verificación de dispositivo
• Deep Link Testing Matrix - casos de prueba de TestFlight

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).