Expo SDK 55 にアップグレードする方法
Product • 2026-02-26 • 読了 11 分
Expo SDK 55 のステップバイステップのヒント、新アーキテクチャ移行のアドバイス、破壊的変更、トラブルシューティングをまとめたガイドです。Expo SDK 55 は React Native 0.83.2 と React 19.2 をサポートします。SDK 54 と同様に、Android API level 36 と Xcode 16.1 以上がサポートされています。最小サポート OS も変わらず、Android 7+ と iOS 15.1 以上でアプリをビルドできます。詳しくは changelog を確認してください。ショートハイライト動画: SDK 55 Highlights
各 SDK は広範なテストとベータ期間を経てリリースされ、Expo チームとコミュニティが協力して、他の開発者がスムーズにアップグレードできるように問題を見つけます。多くの Expo エンジニアは自分たちのアプリをベータ公開直後にアップグレードしてテストしますが、実際にはアプリごとに固有の複雑さがあるため、無数のケースが存在します。本記事では、SDK 55 にアップグレードする際に影響しそうな主要な変更点と、アップグレード全般に役立つ実践的なアドバイスをまとめます。
SDK 55 アップグレード時に知っておくべき主な点
New Architecture（新アーキテクチャ）への移行が必須になりました
SDK 54 / React Native 0.81 が「Old Architecture」を最後にサポートするバージョンでした。SDK 55 を採用する場合、まだ移行していなければ New Architecture を採用する必要があります。SDK 53 で既定になっていたため、ほとんどのアプリは既にアップグレード済みのはずです。下の「New Architecture のアドバイス」を参照してください。
Claude Code を使って SDK アップグレードを支援する
Expo では日常業務で Claude Code を使っています。経験に基づいて、expo/skills ライブラリに一般的なタスクを支援するスキルを公開しています。その一つに「upgrading to the latest Expo SDK version」があり、パッケージの更新だけでなく破壊的変更の適用、古い設定のクリーンアップなども処理してくれます。
- ターミナルの Claude Code で次を実行してスキルマーケットプレイスを追加します:
Code Copy /plugin marketplace add expo/skills
- 次にアップグレードスキルをインストールします:
Code Copy /plugin install upgrading-expo
- その後 Claude を再起動し、プレーンな言葉で SDK アップグレードを依頼できます。正しくインストールされていれば、Claude がスキルを参照して動作を開始します。
- ほかのエージェントに Expo スキルをインポートする場合:
Code Copy bunx skills add expo/skills
常に別ブランチで作業し、マージ前にコードをレビューしてください。LLM は強力ですが、すべてのシナリオを把握できるわけではありません。人間の開発者による確認は不可欠です。
デフォルトプロジェクトとExpo Goの移行期間
App Store や Play Store 用の Expo Go はこのリリース後しばらく SDK 54 のまま維持されます。また、npx create-expo-app で作成されるデフォルトプロジェクトも一貫性のため SDK 54 を使い続けます。Expo Go は素早く始めるための教育ツールなので、この移行期間を利用してプロジェクトを development build に移行することを推奨します。
- 期間中、Android では Expo CLI を通じて SDK 55 用の Expo Go をインストールできます。
- iOS では TestFlight External Beta を使うか、新しい
eas go コマンドで SDK 55 用の Expo Go ビルドを作成して自分の TestFlight チームにアップロードしてください。
development build はストアに出す実際のアプリを構築するために必要なネイティブ設定を含められるため、Expo Go よりも本番環境に近い動作確認ができます。Expo Go は JavaScript を実行できますが、app.json / app.config.js の多くの設定を適用できないため、Expo Go で動作しても本番ビルドで動かない、という問題が起こり得ます。
Android 端末や iOS シミュレータ向けに過去バージョンを入手するには https://expo.dev/go へ。App Store の制約により iOS 実機では過去バージョンを直接使えない点に注意してください。
ローカルでビルドするには次を使います: npx expo run:android または npx expo run:ios。
expo-av → expo-video / expo-audio
SDK 55 で expo-av パッケージは削除されました。以前から段階的に expo-audio と expo-video に置き換えられているため、コードをこれらにアップデートしてください。
Hermes v1 を試す（パフォーマンス向上の可能性）
Hermes v1 コンパイラは意味のあるパフォーマンス改善をもたらす可能性があり、SDK 55 ではオプトインで利用できます。ただし、一部のケースでは React Native をソースからビルドする必要があり、ビルド時間が長くなる場合がある点に注意してください。詳細は SDK 55 changelog を参照してください。
SDK アップグレードのための実用的なヒント
詳細なトラブルシューティングガイドを用意しています（アップグレード前および途中での考慮点、簡単に試せる順での提案リストなど）。ここでは主要ポイントを簡潔にまとめます。
New Architecture（新アーキテクチャ）に関するアドバイス
-
SDK 54 が Old Architecture の最後のサポート版であり、SDK 55 / React Native 0.83 は New Architecture のみをサポートします。まだ移行していない場合は、このタイミングで必ず移行してください。
-
一部の主要パッケージ（例: react-native-reanimated v4、@shopify/flash-list v4 など）は New Architecture のみをサポートしています。
-
Expo SDK のアップグレードと New Architecture の採用を同時に行うのは避けてください。同時に行うと問題の原因切り分けが難しくなります。一般に New Architecture を採用する方が大きな変更になることが多いため、まず New Architecture を SDK 54 上で導入し、development build を作ってテストしてください。New Architecture 化が正しく機能することを確認した後に SDK 55 にアップグレードして新しい development build を作成すると、SDK アップグレードだけを切り分けて検証できます。
トラブルシューティングガイドの確認
- よくあるトラブルシューティングガイドのランディングページを参照してください。ビルド時エラーとクラッシュ／パフォーマンス問題では取るべき手順が異なります。
- 問題を他者に相談する際は、ADB Logcat や macOS Console で取得したネイティブのエラーメッセージがあると非常に助けになります。
助けが必要なときは連絡してください
バグレポートやフィードバックはとても有り難く思っています。問題を最も伝わりやすくする方法は、最小限の再現可能なサンプルを含む GitHub issue です。
- 推奨される再現手順:
npx create-expo-app で作成したデフォルトプロジェクトをベースに、問題を再現するのに必要な最小限のコードだけを含めた Github リポジトリへのリンクを送ってください。最小再現例があればチームは問題を再現でき、修正があなたのケースで機能するかどうかを素早く検証できます。
- 再現例を作る時間（15〜30分）は、実際の大規模アプリで何時間もデバッグするより効率的なことが多いです。
- まだ最小再現例を作れない場合でも、Discord、Reddit、Bluesky などで状況を共有して議論する価値はあります。スクリーンショットや動画、影響を受けるプラットフォーム、具体的に見えている挙動を添えると回答が得やすくなります。
- 単一の問題の最小再現例に収まらないアップグレード体験に関する詳細なフィードバックも歓迎します。サポートページ経由のメッセージも常時確認しています。
Happy upgrading — SDK 55 を気に入っていただけますように！