Mise à niveau de React Native

Aperçu

Couvre le flux de travail complet de mise à niveau de React Native : diffs de modèle via Upgrade Helper, mises à jour de dépendances, étapes Expo SDK et pièges courants.

Séquence de mise à niveau typique

1. Route : Choisir le bon chemin de mise à niveau via upgrading-react-native.md
2. Diff : Récupérer le diff de modèle canonique avec Upgrade Helper via upgrade-helper-core.md
3. Dépendances : Évaluer et mettre à jour les packages tiers via upgrading-dependencies.md
4. React : Aligner la version React si mise à niveau via react.md
5. Expo (le cas échéant) : Appliquer la couche Expo SDK via expo-sdk-upgrade.md
6. Vérifier : Exécuter les vérifications post-mise à niveau via upgrade-verification.md

# Démarrage rapide : détecter la version actuelle et récupérer le diff
npm pkg get dependencies.react-native --prefix "$APP_DIR"
npm view react-native dist-tags.latest

# Exemple : mise à niveau de 0.76.9 vers 0.78.2
# 1. Récupérer le diff du modèle
curl -L -f -o /tmp/rn-diff.diff \
  "https://raw.githubusercontent.com/react-native-community/rn-diff-purge/diffs/diffs/0.76.9..0.78.2.diff" \
  && echo "Diff downloaded OK" || echo "ERROR: diff not found, check versions"
# 2. Examiner les fichiers modifiés
grep -n "^diff --git" /tmp/rn-diff.diff
# 3. Mettre à jour package.json, appliquer les changements natifs, puis installer + rebuilder
npm install --prefix "$APP_DIR"
cd "$APP_DIR/ios" && pod install
# 4. Valider : les deux plateformes doivent se compiler avec succès
npx react-native build-android --mode debug --no-packager
xcodebuild -workspace "$APP_DIR/ios/App.xcworkspace" -scheme App -sdk iphonesimulator build

Quand appliquer

Consultez ces directives quand :

• Vous déplacez une app React Native vers une version plus récente
• Vous reconciliez les changements de configuration native depuis Upgrade Helper
• Vous validez les notes de version pour les breaking changes

Référence rapide

Mappage Problème → Skill