Tous les articles

Mobile9 min de lecture

Migrer vers Expo SDK 58 : ce qui a cassé en React Native

J'ai migré une app React Native en production vers Expo SDK 58 : types plus stricts, barre d'onglets d'expo-router, R8 sur Android et Jest, avec l'avant et l'après.

Aussi en Português, English, Español

Si vous avez une app en React Native et que vous n'êtes pas encore passé à Expo SDK 58, le compte à rebours a déjà commencé : à partir d'avril 2027, Apple n'accepte sur l'App Store que les envois compilés avec le SDK d'iOS 27. Et c'est le SDK 58 qui l'apporte.

J'ai mis à jour une de mes apps React Native, disponible sur les deux stores, du SDK 56 au 58 en une seule journée. Ce n'était pas une catastrophe, mais ce n'était pas non plus une simple commande à lancer. Cet article est la carte de ce qui a cassé et de la façon dont je l'ai réparé, pour que vous ne découvriez pas tout au dernier moment.

TL;DR#

  • TypeScript plus strict : les refs de View, ScrollView et TextInput utilisent maintenant ViewInstance, ScrollViewInstance et TextInputInstance. TextStyle est devenu en lecture seule.
  • expo-router 58 : la barre d'onglets personnalisée ne reçoit plus navigation. C'est désormais emitter et navigateToTab.
  • Android : R8 est activé dans le build de release. Si l'une de vos bibliothèques utilise la réflexion, l'app peut s'ouvrir normalement et ne casser que dans la version du store.
  • Jest : le preset de React Native est devenu un paquet séparé et reanimated a besoin de son propre resolver.
  • iOS 27 : le cycle de vie passe par scène (SceneDelegate). Avec prebuild, c'est déjà prêt.

Une version à la fois#

Ne sautez pas directement du 56 au 58. Je suis d'abord passée au 57, j'ai fait le commit, et seulement ensuite je suis allée au 58. Ça paraît plus long, mais chaque version casse des choses différentes, et mélanger les deux dans le même diff transforme la moindre erreur en casse-tête.

Le 57 s'est bien passé : React Native 0.86, sans changement cassant par rapport à la 0.85, et il a même corrigé une régression mémoire de Hermes avec reanimated que expo-doctor signalait depuis le SDK 56.

Le 58, c'est là qu'est le travail. Il apporte :

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

La démarche que je suis à chaque mise à jour :

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

Le --fix aligne toutes les dépendances sur la version attendue par le SDK. expo-doctor indique ce qui n'est toujours pas aligné. Et c'est là que la partie amusante commence.

Le typecheck juste après la mise à jour : 57 erreurs dans 22 fichiers, toutes dues aux nouveaux types de React Native 0.88

1. Les types sont devenus plus stricts#

React Native 0.88 a réécrit une bonne partie de ses types. Rien ne change à l'exécution, mais tsc commence à se plaindre de choses qui passaient avant.

Refs de composants natifs#

Le type du ref n'est plus le composant lui-même, c'est maintenant une « instance » :

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

Le remplacement est mécanique : View devient ViewInstance, ScrollView devient ScrollViewInstance et TextInput devient TextInputInstance. Même chose pour forwardRef :

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

Astuce : si vous passez un ref à une fonction de capture d'écran, comme dans react-native-view-shot, le type du RefObject change aussi.

TextStyle est maintenant en lecture seule#

Celui-là m'a piégée dans un composant de texte qui ajuste la taille de la police. Avant, je construisais le style et j'y ajoutais des propriétés au fur et à mesure :

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
}

Avec TextStyle en lecture seule, la solution est de construire l'objet d'un seul coup :

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

Au final, c'est même plus lisible.

Les petits#

Trois corrections d'une ligne qu'on retrouve dans presque toutes les apps :

  • ListFooterComponent n'accepte plus null. Remplacez le : null du ternaire par : undefined.
  • AppState.currentState peut valoir null. Si vous stockez cette valeur dans un type à vous, incluez null.
  • Le onRefresh de RefreshControl attend une fonction qui ne renvoie rien. Si vous passez directement le refetch de React Query, il renvoie une Promise et TypeScript se plaint.
<RefreshControl onRefresh={() => void refetch()} refreshing={isRefetching} />

2. La barre d'onglets d'expo-router#

Si vous utilisez une barre d'onglets personnalisée, c'est l'erreur qui va apparaître à l'écran, pas seulement dans tsc. expo-router 58 a retiré navigation des props de tabBar. À la place, vous recevez emitter et 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);
  };
  // ...
}

Notez que navigateToTab reçoit la clé de la route (route.key), pas son nom, comme le faisait navigation.navigate.

La barre d'onglets flottante est de retour, maintenant avec emitter et navigateToTab

3. R8 sur Android est activé#

C'est le plus dangereux, parce que rien ne casse sur votre machine. Le SDK 58 minifie désormais le build de release Android avec R8 par défaut. R8 raccourcit les noms et supprime le code qui semble inutilisé.

Le problème : les bibliothèques qui utilisent la réflexion cherchent des classes par leur nom à l'exécution. Si R8 a renommé ou supprimé cette classe, l'app s'ouvre puis plante au moment d'utiliser la fonctionnalité. Et ça n'apparaît que dans l'AAB de release, celui qui part sur le store.

Dans mon app, la liste des suspects était longue : le SDK publicitaire, la connexion Google et les achats intégrés. Sans le temps de tester chaque règle keep dans un vrai build de release, j'ai préféré désactiver R8 et en faire une décision à part :

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

Ce n'est pas que R8 soit mauvais. Il rend l'app plus légère et plus rapide. Mais activer R8 demande un test de release de bout en bout, et ça n'a pas sa place au milieu d'une mise à jour de SDK.

4. Jest#

Si vous lancez des tests, préparez-vous un café. Deux choses ont changé.

Le preset de React Native est devenu un paquet séparé : @react-native/jest-preset. jest-expo pointe déjà vers lui, mais il apporte son propre resolver.

reanimated a aussi besoin du sien. Sans lui, l'import de reanimated plante avant le premier test, parce qu'il n'y a pas de module natif sous Jest :

Sans le resolver de reanimated, le test plante avant même de s'exécuter

Le problème, c'est que la configuration de Jest n'accepte qu'un seul resolver. La solution a été de réunir les deux dans un fichier :

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

Celui de reanimated décide quel fichier charger (la version JS, pas la native). Celui du preset fait la résolution proprement dite. Et dans jest.config.js :

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

Il y avait encore un détail : expo-asset appelle désormais une méthode du <Image> de React Native au chargement. Dans les specs qui remplacent <Image> par une doublure, cette méthode n'existe pas et le test plante. Je l'ai résolu en pointant expo-asset vers la version du resolver qui ne passe pas par <Image> :

// jest.setup.ts
jest.mock("./node_modules/expo-asset/build/resolveAssetSource", () =>
  jest.requireActual("./node_modules/expo-asset/build/resolveAssetSource.js"),
);
Le même test avec le nouveau resolver : 22 sur 22

Et iOS 27 ?#

Les apps compilées avec le SDK d'iOS 27 doivent utiliser le cycle de vie par scène. En pratique, cela veut dire un SceneDelegate.swift et une nouvelle entrée dans l'Info.plist.

Si vous utilisez prebuild (le dossier ios n'est pas dans git et c'est Expo qui le génère), npx expo prebuild génère déjà tout ça. Pour mon app, c'était le cas, et je n'ai rien eu à toucher côté natif.

Si vous gardez le dossier ios dans le dépôt, c'est à vous de jouer : comparez ce que prebuild génère dans un nouveau projet SDK 58 avec le vôtre, et rapatriez le SceneDelegate et le UIApplicationSceneManifest.

Checklist pour votre mise à jour#

  • Montez une version de SDK à la fois, avec un commit pour chacune.
  • Lancez npx expo install --fix et npx expo-doctor jusqu'à ce qu'il ne reste que ce que vous avez choisi de garder.
  • Passez les refs à ViewInstance, ScrollViewInstance et TextInputInstance.
  • Cherchez les styles construits par mutation (style.something = ...) et réécrivez-les avec le spread.
  • Barre d'onglets personnalisée : remplacez navigation par emitter et navigateToTab(route.key).
  • Décidez pour R8 en connaissance de cause : soit vous le désactivez, soit vous testez un build de release de bout en bout.
  • Réunissez les resolvers de Jest si vous utilisez reanimated.
  • Générez un build iOS avec le nouveau SDK avant avril 2027, pas en avril 2027.

expo-doctor n'a pas besoin d'arriver à zéro#

J'ai relancé expo-doctor deux semaines après la migration, avec l'app déjà en production. Résultat : 17 sur 20.

Deux semaines plus tard : 17 sur 20, et chaque avertissement a sa raison

Les trois avertissements disent des choses très différentes :

  • Deux fichiers de lock. Le projet a un package-lock.json et un pnpm-lock.yaml. Sur une CI qui devine le gestionnaire de paquets d'après le fichier, ça prête à confusion. Ici, c'est un choix assumé, mais si vous n'avez pas de raison, supprimez celui que vous n'utilisez pas.
  • eas-cli dans le projet. Expo préfère qu'il soit lancé avec npx eas ou installé globalement. C'est un avertissement d'hygiène, ça ne casse rien.
  • Versions de correctif. Expo publie des correctifs du SDK chaque semaine. C'est le seul qui vaut la peine d'être réglé tout de suite : npx expo install --fix et un test rapide.

La règle que je suis : les avertissements de version, je les corrige ; les avertissements de choix, je les documente. Mettre le doctor à zéro n'est pas l'objectif. Savoir pourquoi chaque avertissement est là, si.

Ce que j'ai appris#

tsc est le meilleur guide de migration qui existe. Presque tout ce qui a cassé dans le 58 est d'abord apparu comme une erreur de type. Si votre projet a encore beaucoup de any, chaque mise à jour fera plus mal.

Ce qui ne casse qu'en release est ce qui compte le plus. TypeScript et Jest crient tout de suite. R8 reste silencieux jusqu'à ce que l'app arrive entre les mains de quelqu'un. C'est pour ça qu'il a mérité sa propre décision, avec un commentaire dans le code qui explique pourquoi.

Une mise à jour de SDK, ce n'est pas une tâche du vendredi après-midi. Une version à la fois, un commit par version, et un build de release avant d'envoyer sur le store.

Références#

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

Écrit par

Ingénieure logiciel et designer. J'écris sur ce que je rencontre en créant des apps, des APIs et des produits.