Lanzamiento por fases e reversión

Pausar el lanzamiento progresivo de iOS y detener la publicación escalonada de Play - el libro de recetas para contener lanzamientos incorrectos en aplicaciones Expo SDK 57 sin esperar a que se expongan a todos los usuarios. La carga aún se realiza a través de EAS Submit; esta página cubre las acciones del operador en App Store Connect y Play Console después de que una compilación esté activa o parcialmente activa.

Receta

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

## Árbol de decisiones de reversión (primeros 15 minutos)
1. Confirma el número de compilación incorrecta en Sentry / Play Vitals que coincida con el lanzamiento activo
2. Clasifica: fallo nativo (compilación de tienda) vs lógica JS (candidato para EAS Update)
3. iOS: App Store Connect → pausa el lanzamiento progresivo
4. Android: Play Console → detén la publicación escalonada
5. Si es nativo: prepara una compilación de corrección rápida O promociona el último versionCode / buildNumber conocido como bueno
6. Publica la página de estado + banner en la aplicación si la autenticación o pago está roto

# Ruta de corrección rápida - incrementa números de compilación, reconstruye, reenvía
# app.config.ts: ios.buildNumber + android.versionCode incrementados
eas build --profile production --platform all
eas submit --platform ios --latest
eas submit --platform android --latest

Cuándo usarlo:

• La tasa sin fallos cae > 0,5% durante el primer día del lanzamiento.
• La tasa de ANR se duplica en vitales de Android en publicación escalonada al 20%.
• Regresión de pago o autenticación confirmada en producción - no es una prueba A/B inestable.
• El marketing se lanzó antes de que la ingeniería validara las métricas de cohorte en fase.
• Necesitas detener nuevos adoptantes mientras decides entre una corrección OTA y una compilación binaria de corrección rápida.

Ejemplo de trabajo

Escenario - Regresión 2.4.0 en lanzamiento parcial

Síntomas: Lanzamiento progresivo de iOS día 2 (~28% de usuarios); Android en publicación escalonada al 20%. Sentry muestra una tasa de fallos del 3,2% en 240012 (línea base 0,4%). Seguimiento de pila: puntero nulo en módulo nativo después de actualización RN 0.86.

Paso 1 - Pausa la nueva exposición

• Pausa el lanzamiento progresivo de iOS - los usuarios que ya recibieron la actualización la mantienen; ningún usuario nuevo obtiene 2.4.0 hasta que se reanude o reemplace.
• Detén el lanzamiento de Play - mismo comportamiento; las instalaciones existentes se mantienen en la compilación incorrecta hasta que se actualicen nuevamente.

Paso 2 - Evalúa las opciones de reversión

Este fallo es nativo - OTA no ayudará. Procede con la compilación de corrección rápida 2.4.1 240013.

Paso 3 - iOS: estrategia de lanzamiento mientras está pausada

1. Compila y envía IPA de corrección rápida a través de EAS.
2. Envía 2.4.1 para revisión de App - menciona corrección de regresión en notas de revisión.
3. Opciones mientras esperas:
   • Deja lanzamiento progresivo de 2.4.0 pausado (limita el radio de impacto).
   • Si Apple aprueba 2.4.1 antes de que expire la pausa, lanza 2.4.1 con lanzamiento progresivo habilitado - no reanudes 2.4.0.
4. No puedes "degradar" usuarios en iOS - los usuarios en 2.4.0 necesitan la corrección hacia adelante 2.4.1.

<!-- Nota de revisión del anexo de App Store Connect -->
2.4.1 corrige fallo al arranque en frío (problema de Sentry SHOP-4412) introducido en compilación 240012 de 2.4.0.
El lanzamiento progresivo de 2.4.0 está pausado. Ningún usuario nuevo recibe 2.4.0.

Paso 4 - Android: detener - lanzamiento sustituto

1. Play Console → Producción → confirma que el lanzamiento está detenido al 20%.
2. Carga AAB de corrección rápida versionCode 240013 a través de eas submit.
3. Crea un nuevo lanzamiento de producción con 100% o reinicia publicación escalonada al 5% para la corrección.
4. Google no reemplaza instalaciones automáticamente - los usuarios en 2.4.0 extraen 2.4.1 cuando se actualizan.

// eas.json - envío de corrección rápida (mismos perfiles, nuevo versionCode en app.config.ts)
{
  "submit": {
    "production": {
      "android": {
        "serviceAccountKeyPath": "./secrets/play-service-account.json",
        "track": "production"
      }
    }
  }
}

Paso 5 - Reanuda lanzamiento seguro

Paso 6 - Ganchos de reflexión post-mortem

• Etiqueta lanzamientos de Sentry con buildNumber / versionCode.
• Añade lista de verificación ir/no-ir a Conceptos básicos de operaciones de tienda ejemplo 9.
• Archivo de documentación de incidente si la gravedad lo justifica - Respuesta ante incidentes de tienda.

Referencia de lanzamiento progresivo de iOS

Controles en App Store Connect:

• Pausa el lanzamiento progresivo - congela el porcentaje hasta que se reanude.
• Lanza actualización a todos los usuarios - salta los días de fase restantes (usa solo cuando la corrección rápida está validada).
• Desactiva el lanzamiento progresivo en la siguiente versión - 100% instantáneo (riesgo más alto).

Los usuarios que actualicen manualmente desde la App Store pueden recibir la compilación inmediatamente independientemente de la fase - el lanzamiento progresivo se aplica a las actualizaciones automáticas.

Referencia de publicación escalonada de Android

Vitales de Android (Play Console → Calidad → Vitales de Android):

• Tasa de fallos percibida por el usuario
• Tasa de ANR
• Compara versionCode - no solo estadísticas de aplicación agregadas.

EAS Update como mitigación parcial

Cuando el error es solo JavaScript y la política de versión de tiempo de ejecución lo permite:

eas update --branch production --message "fix: cart total rounding"

• Los usuarios en la compilación nativa incorrecta aún necesitan corrección de tienda si cambió el código nativo.
• No hagas OTA sobre una regresión nativa de fallo al iniciar - la aplicación nunca alcanza el paquete JS.
• Empareja con banderas de características para desactivar pantallas rotas mientras la actualización se propaga.

Limitaciones de reversión

Preguntas frecuentes

Relacionado

• Flujo de trabajo de App Store Connect - lanzamiento progresivo al enviar
• Flujo de trabajo de Google Play Console - configuración de publicación escalonada
• Conceptos básicos de operaciones de tienda - monitoreo después del lanzamiento
• Banderas de características para lanzamiento seguro - mitigación de JS
• EAS Submit - carga de corrección rápida
• Respuesta ante incidentes de tienda - comunicaciones de cortes severos

Versiones de pila: Esta página se escribió para React 19.2.3, React Native 0.86.0, y Expo SDK 57 (expo ~57.0.4).