React Native のアップグレード

概要

React Native のアップグレードワークフロー全体をカバーします。Upgrade Helper のテンプレートdiff、依存関係の更新、Expo SDK の手順、一般的な落とし穴が含まれます。

典型的なアップグレードシーケンス

1. ルート選択: upgrading-react-native.md で適切なアップグレードパスを選択
2. Diff の取得: upgrade-helper-core.md で Upgrade Helper を使用して正式なテンプレートdiffを取得
3. 依存関係: upgrading-dependencies.md でサードパーティパッケージを評価・更新
4. React: react.md でアップグレードされた場合は React のバージョンを合わせる
5. Expo (該当する場合): expo-sdk-upgrade.md で Expo SDK レイヤーを適用
6. 検証: upgrade-verification.md でアップグレード後の確認を実行

# クイックスタート: 現在のバージョンを検出してdiffを取得
npm pkg get dependencies.react-native --prefix "$APP_DIR"
npm view react-native dist-tags.latest

# 例: 0.76.9 から 0.78.2 へアップグレード
# 1. テンプレートdiffを取得
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. 変更されたファイルを確認
grep -n "^diff --git" /tmp/rn-diff.diff
# 3. package.json を更新し、ネイティブの変更を適用してからインストール + ビルド
npm install --prefix "$APP_DIR"
cd "$APP_DIR/ios" && pod install
# 4. 検証: 両プラットフォームが正常にビルドされることを確認
npx react-native build-android --mode debug --no-packager
xcodebuild -workspace "$APP_DIR/ios/App.xcworkspace" -scheme App -sdk iphonesimulator build

適用時期

以下のガイドラインを参照して、以下の場合に適用します:

• React Native アプリを新しいバージョンに移行する場合
• Upgrade Helper からのネイティブ設定変更を調整する場合
• リリースノートで破壊的変更を検証する場合

クイックリファレンス

問題 → スキルマッピング