Todos os artigos

Mobile9 min de leitura

Expo SDK 58: o que quebrou ao atualizar meu app

Atualizei um app React Native em produção pro Expo SDK 58: tipos mais rígidos, a barra de abas do expo-router, o R8 no Android e o Jest, com o antes e depois.

Também em English, Español, Français

Se você tem um app em React Native e ainda não subiu pro Expo SDK 58, o relógio já está correndo: a partir de abril de 2027 a Apple só aceita envio pra App Store compilado com o SDK do iOS 27. E é o SDK 58 que traz isso.

Eu atualizei um app meu em React Native que está nas duas lojas, do SDK 56 pro 58 num dia só. Não foi um desastre, mas também não foi só rodar um comando. Esse post é o mapa do que quebrou e de como eu consertei, pra você não descobrir tudo no susto.

TL;DR#

  • TypeScript mais rígido: ref de View, ScrollView e TextInput agora usa ViewInstance, ScrollViewInstance e TextInputInstance. TextStyle virou somente leitura.
  • expo-router 58: a barra de abas customizada não recebe mais navigation. Agora é emitter e navigateToTab.
  • Android: o R8 vem ligado no build de release. Se alguma biblioteca sua usa reflexão, o app pode abrir e quebrar só na loja.
  • Jest: o preset do React Native virou pacote separado e o reanimated precisa de um resolvedor próprio.
  • iOS 27: o ciclo de vida passa a ser por cena (SceneDelegate). Com prebuild, isso vem pronto.

Uma versão de cada vez#

Não pule direto do 56 pro 58. Eu subi pro 57 primeiro, fiz o commit, e só então fui pro 58. Parece mais trabalho, mas cada versão quebra coisas diferentes, e misturar as duas no mesmo diff transforma qualquer erro num quebra-cabeça.

O 57 foi tranquilo: React Native 0.86, sem quebra sobre a 0.85, e ainda corrigiu uma regressão de memória do Hermes com o reanimated que o expo-doctor vinha acusando desde o SDK 56.

O 58 é onde mora o trabalho. Ele traz:

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

O caminho que eu sigo em toda atualização:

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

O --fix alinha todas as dependências com a versão que o SDK espera. O expo-doctor aponta o que ainda está fora. E aí começa a parte divertida.

O typecheck logo depois do upgrade: 57 erros em 22 arquivos, todos dos tipos novos da React Native 0.88

1. Os tipos ficaram mais rígidos#

A React Native 0.88 reescreveu boa parte dos tipos. Nada muda em tempo de execução, mas o tsc passa a reclamar de coisas que antes passavam.

Ref de componente nativo#

O tipo do ref deixou de ser o próprio componente e virou uma "instância":

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

A troca é mecânica: View vira ViewInstance, ScrollView vira ScrollViewInstance e TextInput vira TextInputInstance. Vale o mesmo pro forwardRef:

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

Dica: se você passa ref pra função de captura de tela, como no react-native-view-shot, o tipo do RefObject muda junto.

TextStyle agora é somente leitura#

Esse me pegou num componente de texto que ajusta o tamanho da fonte. Antes eu montava o estilo e ia acrescentando propriedades:

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
}

Com o TextStyle somente leitura, a saída é montar o objeto de uma vez só:

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

Fica até mais legível, no fim.

Os pequenos#

Três ajustes de uma linha que aparecem em quase todo app:

  • ListFooterComponent não aceita mais null. Troque o : null do ternário por : undefined.
  • AppState.currentState pode vir null. Se você guarda esse valor num tipo seu, inclua o null.
  • onRefresh do RefreshControl espera uma função que não devolve nada. Se você passa o refetch do React Query direto, ele devolve uma Promise e o TypeScript reclama.
<RefreshControl onRefresh={() => void refetch()} refreshing={isRefetching} />

2. A barra de abas do expo-router#

Se você usa uma barra de abas customizada, esse é o erro que vai aparecer na tela, não só no tsc. O expo-router 58 tirou o navigation das props do tabBar. No lugar dele vêm emitter e 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);
  };
  // ...
}

Repara que o navigateToTab recebe a chave da rota (route.key), não o nome, como o navigation.navigate recebia.

A barra de abas flutuante de volta, agora com emitter e navigateToTab

3. O R8 do Android vem ligado#

Esse é o mais perigoso, porque não quebra nada no seu computador. O SDK 58 passou a minificar o build de release do Android com o R8 por padrão. O R8 encurta nomes e remove código que parece não ser usado.

O problema: bibliotecas que usam reflexão procuram classes pelo nome em tempo de execução. Se o R8 renomeou ou removeu essa classe, o app abre e quebra na hora de usar o recurso. E isso só aparece no AAB de release, o que vai pra loja.

No meu app, a lista de suspeitos era grande: SDK de anúncios, login do Google e compras dentro do app. Sem tempo de testar cada regra de keep num build de release de verdade, eu preferi desligar o R8 e tratar isso como uma decisão separada:

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

Não é que o R8 seja ruim. Ele deixa o app menor e mais rápido. Mas ligar o R8 pede um teste de release de ponta a ponta, e isso não cabe no meio de um upgrade de SDK.

4. O Jest#

Se você roda testes, prepare um café. Duas coisas mudaram.

O preset do React Native virou pacote separado: @react-native/jest-preset. O jest-expo já aponta pra ele, mas ele traz um resolvedor próprio.

O reanimated precisa do resolvedor dele também. Sem isso, o import do reanimated cai antes do primeiro teste, porque debaixo do Jest não existe módulo nativo:

Sem o resolvedor do reanimated, o teste cai antes de rodar

O problema é que a configuração do Jest aceita um resolvedor só. A saída foi juntar os dois num arquivo:

// 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 }),
  });

O do reanimated decide qual arquivo carregar (a versão em JS, não a nativa). O do preset faz a resolução em si. E no jest.config.js:

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

Teve mais um detalhe: o expo-asset passou a chamar um método do <Image> do React Native ao carregar. Nas specs que trocam o <Image> por um dublê, esse método não existe e o teste cai. Resolvi apontando o expo-asset pra versão do resolvedor que não passa pelo <Image>:

// jest.setup.ts
jest.mock("./node_modules/expo-asset/build/resolveAssetSource", () =>
  jest.requireActual("./node_modules/expo-asset/build/resolveAssetSource.js"),
);
O mesmo teste com o resolvedor novo: 22 de 22

E o iOS 27?#

Apps compilados com o SDK do iOS 27 precisam usar o ciclo de vida por cena. Na prática, isso quer dizer um SceneDelegate.swift e uma entrada nova no Info.plist.

Se você usa prebuild (a pasta ios não vai pro git e é gerada pelo Expo), o npx expo prebuild já gera tudo isso. No meu app foi assim, e eu não precisei mexer em nada nativo.

Se você mantém a pasta ios no repositório, aí é com você: compare o que o prebuild gera num projeto novo do SDK 58 com o seu e traga o SceneDelegate e o UIApplicationSceneManifest pra dentro.

Checklist pra sua atualização#

  • Suba uma versão de SDK por vez, com um commit pra cada.
  • Rode npx expo install --fix e npx expo-doctor até sobrar só o que você decidiu manter.
  • Troque os refs pra ViewInstance, ScrollViewInstance e TextInputInstance.
  • Procure estilos montados com mutação (estilo.algo = ...) e reescreva com spread.
  • Barra de abas customizada: troque navigation por emitter e navigateToTab(route.key).
  • Decida o R8 de propósito: ou desliga, ou testa um build de release de ponta a ponta.
  • Junte os resolvedores do Jest se você usa reanimated.
  • Gere um build de iOS com o SDK novo antes de abril de 2027, não em abril de 2027.

O expo-doctor não precisa zerar#

Rodei o expo-doctor de novo duas semanas depois da migração, com o app já em produção. Resultado: 17 de 20.

Duas semanas depois: 17 de 20, e cada aviso tem um motivo

Os três avisos dizem coisas bem diferentes:

  • Dois arquivos de lock. O projeto tem package-lock.json e pnpm-lock.yaml. Num CI que adivinha o gerenciador pelo arquivo, isso confunde. Aqui é uma escolha consciente, mas se você não tem um motivo, apague o que não usa.
  • eas-cli dentro do projeto. O Expo prefere que ele rode com npx eas ou instalado global. É um aviso de higiene, não quebra nada.
  • Versões de correção. O Expo solta correções do SDK toda semana. Esse é o único que vale resolver logo: npx expo install --fix e um teste rápido.

A regra que eu sigo: aviso de versão eu resolvo; aviso de escolha eu documento. Zerar o doctor não é o objetivo. Saber por que cada aviso está lá, é.

O que aprendi#

O tsc é o melhor guia de migração que existe. Quase tudo que quebrou no 58 apareceu primeiro como erro de tipo. Se o seu projeto ainda tem muito any, cada upgrade vai doer mais.

O que quebra só em release é o que mais importa. O TypeScript e o Jest gritam na hora. O R8 fica quieto até o app chegar na mão de alguém. Por isso ele mereceu uma decisão própria, com um comentário no código explicando o porquê.

Upgrade de SDK não é tarefa de sexta à tarde. Uma versão por vez, um commit por versão, e build de release antes de mandar pra loja.

Referências#

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

Escrito por

Engenheira de software e designer. Escrevo sobre o que encontro construindo apps, APIs e produtos.