upgrading-expo

Vue d’ensemble de la skill upgrading-expo

Ce que fait la skill upgrading-expo

La skill upgrading-expo vous aide à planifier et exécuter une montée de version Expo SDK avec moins d’angles morts qu’un simple prompt du type « comment mettre à jour Expo ? ». Elle se concentre sur le vrai travail : mettre à jour les packages essentiels, corriger les dérives de dépendances, vider les caches obsolètes et repérer les changements cassants fréquents autour de React, de la New Architecture, des Native Tabs et des migrations expo-av.

À qui s’adresse upgrading-expo

Cette upgrading-expo skill convient surtout aux développeurs frontend, aux équipes React Native et aux agents IA qui maintiennent une application Expo existante. Elle est particulièrement utile si vous avez déjà un projet et que vous cherchez un chemin de mise à niveau concret, pas seulement un résumé des release notes.

Cas où elle est la plus pertinente :

• montée de version entre des versions récentes d’Expo SDK
• correction de problèmes d’installation ou d’exécution après expo install --fix
• migration hors de packages modifiés ou scindés comme expo-av
• vérification de l’impact de changements propres à un SDK, comme React 19 ou Native Tabs, sur votre base de code

Le vrai besoin auquel elle répond

Les personnes qui évaluent upgrading-expo for Frontend Development veulent généralement obtenir rapidement la réponse à trois questions :

1. Quelle suite de commandes faut-il lancer en premier ?
2. Quels changements cassants ont le plus de chances d’affecter mon application ?
3. Quels fichiers ou motifs dois-je inspecter avant de perdre du temps en débogage ?

Cette skill est utile parce qu’elle regroupe ces décisions au même endroit et les relie à des références de migration concrètes.

Ce qui la distingue d’un prompt de mise à jour générique

Un prompt classique peut suggérer « mets Expo à jour et lance doctor ». La skill upgrading-expo va plus loin en faisant remonter des sujets de migration liés aux versions directement depuis le dépôt, notamment :

• les valeurs par défaut de la New Architecture à partir de SDK 53+
• les changements liés à React 19 dans SDK 54
• la configuration de React Compiler dans SDK 54+
• les changements d’API Native Tabs dans SDK 55
• les chemins de remplacement de expo-av pour l’audio et la vidéo

Elle est donc plus adaptée à un travail de mise à niveau ciblé qu’un prompt large de dépannage React Native.

Ce qu’il faut savoir avant d’installer

Cette skill mise davantage sur l’accompagnement que sur l’automatisation. Elle ne fournit pas de scripts qui inspectent votre dépôt à votre place. Sa valeur vient d’un workflow de mise à niveau structuré et de documents de référence que vous appliquez à votre propre codebase. Si vous cherchez un migrateur en un clic, ce n’est pas le bon choix. Si vous voulez une checklist de montée de version à fort signal, avec des exemples de migration concrets, c’est une très bonne option.

Comment utiliser la skill upgrading-expo

Contexte d’installation pour upgrading-expo

Si votre environnement IA prend en charge les Skills, installez le dépôt des skills Expo puis invoquez upgrading-expo depuis celui-ci. Un schéma courant est :

npx skills add https://github.com/expo/skills --skill upgrading-expo

Si votre toolchain utilise un autre chargeur de skills, pointez-le vers le chemin du dépôt :
plugins/expo/skills/upgrading-expo

Commencez par les bons fichiers du dépôt

Pour une utilisation pratique de upgrading-expo, lisez ces fichiers dans cet ordre :

1. SKILL.md
2. references/new-architecture.md
3. references/react-19.md
4. references/react-compiler.md
5. references/native-tabs.md
6. references/expo-av-to-audio.md
7. references/expo-av-to-video.md

Cet ordre de lecture reflète les blocages de montée de version les plus courants : d’abord les changements d’architecture et de React, ensuite les migrations au niveau des fonctionnalités.

Appliquez d’abord la séquence de mise à niveau de base

Le flux de base proposé par la skill est court, et il vaut mieux le suivre avant de partir dans un débogage plus profond :

npx expo install expo@latest
npx expo install --fix
npx expo-doctor
npx expo export -p ios --clear
rm -rf node_modules .expo
watchman watch-del-all

Pourquoi c’est important :

• expo@latest aligne le SDK
• --fix réconcilie les versions des packages gérés par Expo
• expo-doctor détecte tôt les problèmes de compatibilité
• le nettoyage des caches supprime d’anciens états Metro/natifs qui peuvent ressembler à des bugs de mise à niveau

Si vous êtes sous Linux ou que vous n’utilisez pas Watchman, adaptez le nettoyage en conséquence.

Sachez quand utiliser les versions preview

La skill documente aussi les builds bêta Expo via les versions .preview sous @next. C’est utile si vous validez un SDK à venir ou testez un correctif qui n’est pas encore arrivé en stable.

npx expo install expo@next --fix

Ne le faites que volontairement. Les mises à jour preview ne sont pas un bon choix par défaut pour une application en production, sauf si vous testez explicitement une préversion.

Donnez les informations dont la skill a réellement besoin

Les meilleurs prompts pour un upgrading-expo guide incluent votre état actuel et votre cible. Donnez à la skill :

• la version actuelle d’Expo SDK
• votre gestionnaire de paquets
• si vous utilisez Expo Go ou des development builds
• si vous utilisez prebuild
• les packages clés : expo-router, expo-av, react-native-reanimated, modules natifs personnalisés
• les erreurs actuelles à l’installation, au build ou à l’exécution
• tout échec spécifique à iOS, Android ou au web

Sans ce contexte, la réponse restera générique.

Transformez un objectif vague en prompt solide

Prompt faible :

Upgrade my Expo app.

Prompt plus solide :

Use the upgrading-expo skill to move my app from Expo SDK 53 to 54. We use expo-router, expo-av, Reanimated, and development builds. After npx expo install --fix, expo-doctor reports dependency mismatches and our app fails on startup with video playback errors. Tell me the likely breaking changes, the commands to run in order, and the code areas I should inspect first.

Pourquoi cela fonctionne :

• il précise la version source et la version cible du SDK
• il liste les packages à risque élevé
• il demande une réponse priorisée, pas des conseils génériques

Faites correspondre votre application aux guides de référence

Les références du dépôt sont particulièrement utiles si vous les rattachez délibérément à la surface de dépendances de votre application :

• Vous utilisez expo-av pour le son ou l’enregistrement ? Lisez references/expo-av-to-audio.md
• Vous utilisez expo-av pour la vidéo ? Lisez references/expo-av-to-video.md
• Vous passez à SDK 55 avec expo-router/unstable-native-tabs ? Lisez references/native-tabs.md
• Vous entrez dans SDK 53+ ou 54+ avec des modules natifs ? Lisez references/new-architecture.md
• Vous êtes sur SDK 54 ? Consultez à la fois references/react-19.md et references/react-compiler.md

C’est ici que la skill apporte un vrai gain d’information par rapport à une simple lecture rapide du dépôt.

Surveillez les zones de montée de version les plus risquées

En pratique, ce sont les points de rupture les plus fréquents mis en avant par la skill :

• désalignement des versions de packages après un bump du SDK
• incompatibilité avec la New Architecture dans d’anciens modules natifs
• changements de configuration Reanimated, y compris react-native-worklets dans SDK 54+
• évolutions d’API React 19 dans le code applicatif ou les bibliothèques
• migrations de expo-av vers expo-audio et expo-video
• changements d’UI au niveau du routeur dans Native Tabs

Si votre application utilise l’un de ces éléments, demandez à la skill de produire une checklist de migration ciblée plutôt qu’un simple résumé général de la mise à niveau.

Utilisez upgrading-expo avec un workflow en deux passes

Un bon schéma d’utilisation de upgrading-expo est :

1. demander un plan de mise à niveau basé sur vos versions et dépendances
2. exécuter les commandes
3. renvoyer les erreurs exactes et demander un plan de remédiation plus ciblé

Cette skill est plus efficace pour un triage structuré si vous revenez avec une sortie concrète de expo-doctor, TypeScript, Metro ou des builds natifs.

Vérifiez les problèmes de type release notes que la skill laisse entendre

La checklist des breaking changes de la skill renvoie vers des zones de revue concrètes :

• API supprimées
• chemins d’import modifiés
• changements de modules natifs nécessitant prebuild
• régressions caméra, audio et vidéo
• régressions de navigation

Autrement dit, votre revue de code ne doit pas s’arrêter à package.json. Cherchez dans votre codebase les imports et composants concernés avant même de lancer l’application.

Utilisez-la avec précaution si vous avez prebuild et du code natif

Si votre application utilise des modules natifs personnalisés ou des config plugins, la upgrading-expo skill reste utile, mais il faut prévoir du travail supplémentaire au-delà des références markdown. Dans ce type de projet, demandez à la skill de séparer :

• les tâches de migration purement JS
• les tâches de régénération prebuild
• les vérifications de compatibilité des dépendances natives

Cette séparation réduit la confusion pendant la montée de version.

FAQ de la skill upgrading-expo

upgrading-expo convient-elle aux débutants ?

Oui, si vous avez déjà un projet Expo et pouvez partager les informations de base du projet. Ce n’est pas un tutoriel Expo complet. C’est un guide centré sur la montée de version ; les débutants obtiennent donc de meilleurs résultats s’ils fournissent la version actuelle du SDK, les erreurs rencontrées et les dépendances principales.

Quelle est la limite de la skill upgrading-expo ?

La skill aide à planifier la mise à niveau, à ordonner les commandes et à cibler les points chauds de migration connus. Elle n’inspecte pas automatiquement l’ensemble de votre dépôt et ne garantit pas la compatibilité de chaque bibliothèque native tierce. En cas de casse native profonde, vous devrez peut-être encore consulter la documentation spécifique des packages et les issues GitHub.

En quoi upgrading-expo est-elle différente du simple fait de demander à un LLM de mettre Expo à jour ?

La principale différence, c’est la curation. La upgrading-expo skill oriente le modèle vers des références de migration spécifiques à Expo qu’un prompt générique peut manquer, en particulier autour de expo-av, React 19, React Compiler, Native Tabs et du comportement de la New Architecture.

Quand ne faut-il pas utiliser upgrading-expo ?

Évitez-la si :

• vous créez une toute nouvelle application Expo au lieu d’en faire évoluer une existante
• votre problème n’a aucun lien avec une montée de version du SDK
• vous avez besoin d’un codemod automatisé ou d’un outil CLI de migration
• votre principal blocage concerne une seule bibliothèque native tierce avec ses propres étapes de migration très spécifiques

upgrading-expo couvre-t-elle les SDK preview ?

Oui. La skill précise que les versions bêta utilisent le suffixe .preview et s’installent depuis @next. C’est utile pour tester des changements à venir, mais les mises à jour stables restent l’option la plus sûre par défaut.

upgrading-expo est-elle réservée aux applications en workflow managed ?

Non. Elle est utile à la fois pour les applications Expo en workflow managed et celles basées sur prebuild, mais prebuild et le code natif personnalisé augmentent la probabilité de devoir faire des vérifications de compatibilité manuelles supplémentaires.

Comment améliorer l’usage de la skill upgrading-expo

Donnez à la skill votre delta de version exact

L’amélioration la plus rentable est simple : indiquez « de SDK X à SDK Y », et pas seulement « upgrade Expo ». L’essentiel des conseils de migration change concrètement selon que vous franchissez SDK 53, 54 ou 55.

Incluez la surface de packages qui change la réponse

Pour de meilleurs résultats avec upgrading-expo, indiquez les packages qui déclenchent les documents de référence :

• expo-av
• expo-router
• react-native-reanimated
• modules natifs personnalisés
• tout package signalé en échec par expo-doctor

Cela permet à la skill de passer d’une checklist générique à des indications probables d’impact.

Collez les diagnostics réels, pas des paraphrases

Mauvais :

build failed after upgrade

Meilleur :

npx expo-doctor says package versions are invalid, Metro reports unresolved import from expo-av, and iOS dev build fails after enabling New Architecture.

Les logs exacts aident la skill à distinguer une dérive de dépendances d’un problème de migration d’API.

Demandez une sortie priorisée

Un format de demande efficace est :

1. commandes à exécuter maintenant
2. cassures probables classées par probabilité
3. fichiers/imports à rechercher
4. étapes de vérification après correction

Cette structure rend le upgrading-expo guide beaucoup plus facile à exécuter quand le temps manque.

Séparez les échecs d’installation des migrations de code

Un mode d’échec fréquent consiste à mélanger les problèmes d’installation des packages avec les changements d’API dans le code source. Demandez à la skill de les traiter dans cet ordre :

• alignement des dépendances
• sortie de doctor
• réinitialisation du cache
• migrations du code source
• vérification à l’exécution

Cela réduit le débogage circulaire.

Demandez des motifs de recherche spécifiques à votre codebase

L’une des meilleures façons d’améliorer la sortie de la upgrading-expo skill consiste à demander des cibles de recherche de type grep. Exemple :

Using the upgrading-expo skill, list the import paths, component names, and hooks I should search for to migrate from expo-av and to verify Native Tabs changes in SDK 55.

Cela transforme des conseils généraux en tâches concrètes de revue de code.

Validez les chemins à risque après le premier passage

Après la première tentative de mise à niveau, testez spécifiquement :

• la lecture audio et l’enregistrement
• la lecture vidéo
• la navigation par onglets
• le démarrage dans Expo Go vs dev build
• tout écran utilisant beaucoup d’animations ou des modules natifs

Ce sont les zones les plus susceptibles de faire ressortir les problèmes de transition SDK couverts par la skill.

Itérez avec des prompts de suivi plus ciblés

Ne demandez pas à la skill de résoudre toute la montée de version encore et encore. Réduisez le périmètre du deuxième prompt :

• « Focus only on React 19 changes in my shared UI package »
• « Focus only on expo-av video migration »
• « Focus only on New Architecture incompatibilities »

Des périmètres plus petits produisent généralement des étapes de remédiation plus claires et plus justes.