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

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

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. バージョンを選択する​

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

💡 メジャーアップデートでは、上部に「useful content」セクションが表示され、アップグレードに役立つリンクが掲載されます。

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

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

shell
# {{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をインストールしてプロジェクトのすべてのキャッシュをクリアし、再度実行することをお勧めします。