upgrade-react-navigation

React Navigation のアップグレード

目標

React Navigation を次のメジャーバージョンにアップグレードし、既存のナビゲーション動作を維持しながら、必要な破壊的変更にすべて対応します。

使用するタイミング

React Navigation のメジャーバージョン（6.x → 7.x または 7.x → 8.x）をアップグレードする場合に使用します。

適用方針

このスキルのパターンは、網羅的な一覧ではなく、標準的な出発点として扱ってください。完全に一致する例がなくても、作業を進められます。

• ローカルのコードを最も近いパターンに当てはめて調整してください。構造が異なる場合は、同等の方法を推測してください。
• 動作を維持できる、最もシンプルなアップグレードを優先してください。
• 変更は最小限にし、影響を受けるコードのみをアップグレードしてください。

確認を求めるタイミング

まずローカルのコードを調べてください。

関連するナビゲーターとアップグレードリファレンスを読んだ後も、API が変更されたかどうか、またはどのように更新すればよいかを高い確度で判断できない場合は、作業を中断して、コードを編集する前にユーザーへ確認してください。

次の場合は確認を求めてください。

• ナビゲーターが、公式ドキュメントまたはアップグレードリファレンスに記載されていない API を使用している場合。
• アップグレードにあたり、どの動作変更が許容されるかを推測する必要がある場合。

リファレンス

まず package.json で @react-navigation/native を確認してください。

• 6.x の場合は、references/upgrade-6-to-7.md を読んでください。
• 7.x の場合は、references/upgrade-7-to-8.md を読んでください。
• それ以外のバージョンの場合は、アップグレードガイドに従って、まず 7.x または 8.x にアップグレードしてください。

バージョンを明示的に比較する場合を除き、読み込むリファレンスファイルは 1 つだけにしてください。

検証

アップグレード後は、次の手順を行ってください。

• package.json またはロックファイルからパッケージマネージャーを特定します。
• スクリプトが利用可能な場合は、既存の型チェッカー、リンター、および関連するテストを実行します。
• 読み込んだリファレンスの「自動チェック」と「手動チェック」を実施します。実行できない手順がある場合は、その理由を報告してください。