DocsDigest
Back to listLanguage: JA
OpenAIExpoFeb 26, 2026, 3:45 PM

How to upgrade to Expo SDK 55

A condensed section focused on the key takeaways first.

Original Post
OpenAIClaude

Quick Digest

Summary

A condensed section focused on the key takeaways first.

openaienmodel: gpt-5-mini-2025-08-07

How to upgrade to Expo SDK 55

expo-sdk-55react-native-0.83new-architectureexpo-videohermesdevelopment-builds

Key Points

  • New Architecture is required
  • Replace expo-av with expo-video/expo-audio
  • Use development builds and test on a branch

Summary

Expo SDK 55 moves to React Native 0.83.2 and React 19.2, requires the New Architecture, and drops expo-av in favor of expo-video and expo-audio. This release supports Android API level 36 and Xcode 16.1+, and keeps minimum OS targets at Android 7+ and iOS 15.1+. Use development builds to isolate upgrades from Expo Go and follow a staged approach to minimize risk.

Key Points

  • New Architecture required: SDK 55 no longer supports the Old Architecture — migrate to the New Architecture before or separate from the SDK upgrade.
  • Platform and toolchain: RN 0.83.2, React 19.2, Android API 36, Xcode 16.1+, min OS Android 7+ / iOS 15.1+.
  • Package changes: expo-av removed — replace with expo-video and expo-audio.
  • Hermes v1: opt-in for potential performance gains; may increase build time due to building RN from source.
  • Recommended workflow:
    • Work on a separate branch and create development builds (npx expo run:android / run:ios or eas go) instead of relying on Expo Go.
    • If you haven’t adopted New Architecture, upgrade to New Architecture on SDK 54 first, validate with a development build, then upgrade to SDK 55.
    • Use the SDK 55 changelog and troubleshooting guides before and during the upgrade.
  • Automation: consider the expo/skills Claude Code upgrade skill to automate version updates and common fixes, but always review changes manually.
  • Troubleshooting and support: collect native logs (adb logcat, macOS Console), create a minimal reproduction repo, and open a GitHub issue or discuss on community channels if needed.

Quick Upgrade Checklist

  • Read the SDK 55 changelog and breaking changes.
  • Migrate to New Architecture (preferably on SDK 54).
  • Replace expo-av usage with expo-video / expo-audio.
  • Enable Hermes v1 only after profiling its effects for your app.
  • Build a development build and test on target devices.
  • Open a minimal-repro GitHub issue for any blocking bugs.

Full Translation

Translations

A translation section that keeps the flow of the original article.

openaijamodel: gpt-5-mini-2025-08-07

Expo SDK 55 にアップグレードする方法

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 アップグレードのための実用的なヒント

詳細なトラブルシューティングガイドを用意しています（アップグレード前および途中での考慮点、簡単に試せる順での提案リストなど）。ここでは主要ポイントを簡潔にまとめます。

  • チェンジログを必ず確認する

    • ほとんどの SDK リリースには既知の破壊的変更や、アプリ固有のシナリオで設定調整が必要になる注目点がリストされています。アップグレード前に読むのがベストですが、コンパイルエラーやクラッシュが出た場合はアップグレード後に読むのが次善です。

  • Expo Go よりも development build を使う

    • アップグレードは急いでやる必要はありません。Expo Go は端末で自動的に最新化されるため、ある日突然お手元のプロジェクトが Expo Go で動かなくなり、すぐにアップグレードしなければならないと感じることがあります。development build を使えばそのプレッシャーを和らげられます。
    • development build は QR スキャンでローカル開発ができ、ただし自分のアプリ固有のネイティブ設定を含むため、Expo Go の自動更新による影響を受けません。
    • Expo の Free プランでもいくつかの development build を作成できる余地があります。

  • 問題の切り分けに役立つツールを使う

    • ビルド時のエラー、クラッシュ、パフォーマンス問題では取るべき手順が異なります。ADB Logcat や macOS の Console を使って OS レベルのネイティブエラーを探すと、問題の本質を掴むのに非常に役立ちます。

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 を気に入っていただけますように！