メインコンテンツにスキップ

新しいバージョンへのアップグレード

React Native の新しいバージョンにアップグレードすると、より多くの API、ビュー、開発ツール、その他の優れた機能にアクセスできるようになります。アップグレードには少しの労力が必要ですが、簡単に行えるように努めています。

Expo プロジェクト​

Expo プロジェクトを新しいバージョンの React Native にアップグレードするには、package.json ファイル内の react-native、react、および expo パッケージのバージョンを更新する必要があります。Expo では、SDK のバージョンを一度に 1 つずつ、段階的にアップグレードすることをお勧めします。そうすることで、アップグレードプロセス中に発生する破損や問題を特定しやすくなります。プロジェクトのアップグレードに関する最新情報については、Expo SDK アップグレードのウォークスルーを参照してください。

React Native プロジェクト​

一般的な React Native プロジェクトは、基本的に Android プロジェクト、iOS プロジェクト、および JavaScript プロジェクトで構成されているため、アップグレードは非常に難しい場合があります。Upgrade Helper は、2 つのバージョン間で発生するすべての変更を提供することで、アプリのアップグレードを支援する Web ツールです。また、特定のファイルの変更が必要な理由を理解するのに役立つコメントも表示します。

1. バージョンを選択する​

まず、アップグレード元のバージョンとアップグレード先のバージョンを選択する必要があります。デフォルトでは、最新のメジャーバージョンが選択されています。選択後、「アップグレード方法を表示」ボタンをクリックできます。

💡 メジャーアップデートでは、アップグレード時に役立つリンクを含む「役立つコンテンツ」セクションが上部に表示されます。

2. 依存関係をアップグレードする​

最初に表示されるファイルは package.json です。そこに表示されている依存関係を更新することをお勧めします。たとえば、react-native および react が変更として表示される場合は、次のコマンドを実行してプロジェクトにインストールできます。

# {{VERSION}} and {{REACT_VERSION}} are the release versions showing in the diff
npm install react-native@{{VERSION}}
npm install react@{{REACT_VERSION}}

3. プロジェクトファイルをアップグレードする​

新しいリリースには、npx react-native init を実行したときに生成される他のファイルへの更新が含まれている場合があります。これらのファイルは、Upgrade Helper ページの package.json の後にリストされています。他の変更がない場合は、プロジェクトをリビルドするだけで開発を続行できます。変更がある場合は、手動でプロジェクトに適用する必要があります。

トラブルシューティング​

すべての変更を行いましたが、アプリはまだ古いバージョンを使用しています​

これらの種類のエラーは通常、キャッシングに関連しています。プロジェクトのキャッシュをすべてクリアするために react-native-clean-project をインストールし、再度実行することをお勧めします。