Todos los artículos

Mobile9 min de lectura

Actualizar a Expo SDK 58: qué se rompió en React Native

Actualicé una app React Native en producción a Expo SDK 58: tipos más estrictos, la barra de pestañas de expo-router, R8 en Android y Jest, con el antes y después.

También en Português, English, Français

Si tienes una app en React Native y todavía no subiste a Expo SDK 58, el reloj ya está corriendo: a partir de abril de 2027, Apple solo acepta envíos a la App Store compilados con el SDK de iOS 27. Y es el SDK 58 el que trae eso.

Actualicé una app mía en React Native que está en las dos tiendas, del SDK 56 al 58 en un solo día. No fue un desastre, pero tampoco fue solo correr un comando. Este post es el mapa de lo que se rompió y de cómo lo arreglé, para que no lo descubras todo de golpe.

TL;DR#

  • TypeScript más estricto: los refs de View, ScrollView y TextInput ahora usan ViewInstance, ScrollViewInstance y TextInputInstance. TextStyle pasó a ser de solo lectura.
  • expo-router 58: la barra de pestañas personalizada ya no recibe navigation. Ahora son emitter y navigateToTab.
  • Android: R8 viene activado en el build de release. Si alguna de tus librerías usa reflexión, la app puede abrir y romperse solo en la versión de la tienda.
  • Jest: el preset de React Native pasó a ser un paquete aparte y reanimated necesita su propio resolver.
  • iOS 27: el ciclo de vida pasa a ser por escena (SceneDelegate). Con prebuild, eso ya viene listo.

Una versión a la vez#

No saltes directo del 56 al 58. Primero subí al 57, hice el commit, y solo entonces fui al 58. Parece más trabajo, pero cada versión rompe cosas distintas, y mezclar las dos en el mismo diff convierte cualquier error en un rompecabezas.

El 57 fue tranquilo: React Native 0.86, sin cambios incompatibles respecto a la 0.85, y además corrigió una regresión de memoria de Hermes con reanimated que expo-doctor venía señalando desde el SDK 56.

El 58 es donde está el trabajo. Trae:

  • React Native 0.88
  • React 19.3
  • expo-router 58
  • reanimated 4.7 y worklets 0.13

El camino que sigo en cada actualización:

npx expo install expo@^58.0.0
npx expo install --fix
npx expo-doctor
npm run typecheck
npm test

El --fix alinea todas las dependencias con la versión que el SDK espera. expo-doctor señala lo que todavía está desalineado. Y ahí empieza la parte divertida.

El typecheck justo después del upgrade: 57 errores en 22 archivos, todos por los tipos nuevos de React Native 0.88

1. Los tipos se volvieron más estrictos#

React Native 0.88 reescribió buena parte de sus tipos. Nada cambia en tiempo de ejecución, pero tsc empieza a quejarse de cosas que antes pasaban.

Refs de componentes nativos#

El tipo del ref dejó de ser el propio componente y pasó a ser una "instancia":

import { View, type ViewInstance } from "react-native";
 
function Panel() {
  const panelRef = useRef<ViewInstance>(null);
  return <View ref={panelRef} />;
}

El cambio es mecánico: View pasa a ViewInstance, ScrollView pasa a ScrollViewInstance y TextInput pasa a TextInputInstance. Lo mismo vale para forwardRef:

export const Scrollable = forwardRef<ScrollViewInstance, ScrollableProps>(...)

Consejo: si pasas un ref a una función de captura de pantalla, como en react-native-view-shot, el tipo del RefObject cambia también.

TextStyle ahora es de solo lectura#

Este me atrapó en un componente de texto que ajusta el tamaño de la fuente. Antes armaba el estilo y le iba agregando propiedades:

const scaled: TextStyle = { fontSize: Math.round(base * scale) };
if (typeof flat.lineHeight === "number") {
  scaled.lineHeight = Math.round(flat.lineHeight * scale); // error on RN 0.88
}

Con TextStyle de solo lectura, la salida es armar el objeto de una sola vez:

const scaled: TextStyle = {
  fontSize: Math.round(base * scale),
  ...(typeof flat.lineHeight === "number" && {
    lineHeight: Math.round(flat.lineHeight * scale),
  }),
};

Al final queda hasta más legible.

Los pequeños#

Tres ajustes de una línea que aparecen en casi cualquier app:

  • ListFooterComponent ya no acepta null. Cambia el : null del ternario por : undefined.
  • AppState.currentState puede ser null. Si guardas ese valor en un tipo tuyo, incluye el null.
  • El onRefresh de RefreshControl espera una función que no devuelve nada. Si pasas el refetch de React Query directo, devuelve una Promise y TypeScript se queja.
<RefreshControl onRefresh={() => void refetch()} refreshing={isRefetching} />

2. La barra de pestañas de expo-router#

Si usas una barra de pestañas personalizada, este es el error que va a aparecer en pantalla, no solo en tsc. expo-router 58 quitó navigation de las props de tabBar. En su lugar vienen emitter y navigateToTab.

export function FloatingTabBar({ state, descriptors, emitter, navigateToTab }: BottomTabBarProps) {
  const goTo = (index: number) => {
    const route = state.routes[index];
 
    const event = emitter.emit({
      type: "tabPress",
      target: route.key,
      canPreventDefault: true,
    });
    if (event.defaultPrevented) return;
 
    navigateToTab(route.key);
  };
  // ...
}

Fíjate que navigateToTab recibe la clave de la ruta (route.key), no el nombre, como lo recibía navigation.navigate.

La barra de pestañas flotante de vuelta, ahora con emitter y navigateToTab

3. R8 de Android viene activado#

Este es el más peligroso, porque no rompe nada en tu computadora. El SDK 58 empezó a minificar el build de release de Android con R8 por defecto. R8 acorta nombres y elimina código que parece no usarse.

El problema: las librerías que usan reflexión buscan clases por nombre en tiempo de ejecución. Si R8 renombró o eliminó esa clase, la app abre y se rompe en el momento de usar la funcionalidad. Y eso solo aparece en el AAB de release, el que va a la tienda.

En mi app, la lista de sospechosos era larga: el SDK de anuncios, el inicio de sesión con Google y las compras dentro de la app. Sin tiempo para probar cada regla de keep en un build de release de verdad, preferí desactivar R8 y tratarlo como una decisión aparte:

// app.config.ts
plugins: [
  // ...
  ["expo-build-properties", { android: { enableMinifyInReleaseBuilds: false } }],
],

No es que R8 sea malo. Hace la app más pequeña y más rápida. Pero activar R8 pide una prueba de release de punta a punta, y eso no cabe en medio de un upgrade de SDK.

4. Jest#

Si corres tests, prepárate un café. Cambiaron dos cosas.

El preset de React Native pasó a ser un paquete aparte: @react-native/jest-preset. jest-expo ya apunta a él, pero trae su propio resolver.

reanimated también necesita su resolver. Sin él, el import de reanimated falla antes del primer test, porque bajo Jest no existe módulo nativo:

Sin el resolver de reanimated, el test falla antes de correr

El problema es que la configuración de Jest acepta un solo resolver. La salida fue juntar los dos en un archivo:

// jest.resolver.js
const jestExpoPreset = require("jest-expo/jest-preset");
const reanimatedResolver = require("react-native-reanimated/jest/resolver");
const presetResolver = require(jestExpoPreset.resolver);
 
module.exports = (request, options) =>
  reanimatedResolver(request, {
    ...options,
    defaultResolver: (req, opts) =>
      presetResolver(req, { ...opts, defaultResolver: options.defaultResolver }),
  });

El de reanimated decide qué archivo cargar (la versión en JS, no la nativa). El del preset hace la resolución en sí. Y en jest.config.js:

resolver: "<rootDir>/jest.resolver.js",

Hubo un detalle más: expo-asset empezó a llamar a un método del <Image> de React Native al cargar. En los specs que reemplazan <Image> por un doble de prueba, ese método no existe y el test falla. Lo resolví apuntando expo-asset a la versión del resolver que no pasa por <Image>:

// jest.setup.ts
jest.mock("./node_modules/expo-asset/build/resolveAssetSource", () =>
  jest.requireActual("./node_modules/expo-asset/build/resolveAssetSource.js"),
);
El mismo test con el resolver nuevo: 22 de 22

¿Y iOS 27?#

Las apps compiladas con el SDK de iOS 27 tienen que usar el ciclo de vida por escena. En la práctica, eso significa un SceneDelegate.swift y una entrada nueva en el Info.plist.

Si usas prebuild (la carpeta ios no va a git y la genera Expo), npx expo prebuild ya genera todo eso. En mi app fue así, y no tuve que tocar nada nativo.

Si mantienes la carpeta ios en el repositorio, eso queda en tus manos: compara lo que genera el prebuild en un proyecto nuevo del SDK 58 con el tuyo y trae el SceneDelegate y el UIApplicationSceneManifest a tu proyecto.

Checklist para tu actualización#

  • Sube una versión de SDK a la vez, con un commit para cada una.
  • Corre npx expo install --fix y npx expo-doctor hasta que solo quede lo que decidiste mantener.
  • Cambia los refs a ViewInstance, ScrollViewInstance y TextInputInstance.
  • Busca estilos armados con mutación (style.something = ...) y reescríbelos con spread.
  • Barra de pestañas personalizada: cambia navigation por emitter y navigateToTab(route.key).
  • Decide sobre R8 a propósito: o lo desactivas, o pruebas un build de release de punta a punta.
  • Junta los resolvers de Jest si usas reanimated.
  • Genera un build de iOS con el SDK nuevo antes de abril de 2027, no en abril de 2027.

expo-doctor no necesita llegar a cero#

Corrí expo-doctor de nuevo dos semanas después de la migración, con la app ya en producción. Resultado: 17 de 20.

Dos semanas después: 17 de 20, y cada aviso tiene un motivo

Los tres avisos dicen cosas muy distintas:

  • Dos archivos de lock. El proyecto tiene package-lock.json y pnpm-lock.yaml. En un CI que adivina el gestor de paquetes por el archivo, eso confunde. Aquí es una elección consciente, pero si no tienes un motivo, borra el que no usas.
  • eas-cli dentro del proyecto. Expo prefiere que corra con npx eas o instalado de forma global. Es un aviso de higiene, no rompe nada.
  • Versiones de parche. Expo publica parches del SDK cada semana. Este es el único que vale la pena resolver enseguida: npx expo install --fix y una prueba rápida.

La regla que sigo: los avisos de versión los resuelvo; los avisos de elección los documento. Dejar el doctor en cero no es el objetivo. Saber por qué está cada aviso, sí.

Lo que aprendí#

tsc es la mejor guía de migración que existe. Casi todo lo que se rompió en el 58 apareció primero como error de tipos. Si tu proyecto todavía tiene mucho any, cada upgrade va a doler más.

Lo que se rompe solo en release es lo que más importa. TypeScript y Jest gritan al instante. R8 se queda callado hasta que la app llega a las manos de alguien. Por eso mereció una decisión propia, con un comentario en el código explicando el porqué.

Un upgrade de SDK no es tarea de viernes por la tarde. Una versión a la vez, un commit por versión, y un build de release antes de mandarlo a la tienda.

Referencias#

  • Mobile
  • expo
  • react-native
  • ios
  • android
  • typescript
  • jest

Escrito por

Ingeniera de software y diseñadora. Escribo sobre lo que encuentro construyendo apps, APIs y productos.