ClaudeExpoFeb 26, 2026, 3:45 PM

How to upgrade to Expo SDK 55

A condensed section focused on the key takeaways first.

Original Post

Quick Digest

Summary

A condensed section focused on the key takeaways first.

claudeenmodel: claude-sonnet-4-20250514

Expo SDK 55 Upgrade Guide: New Architecture Required

Key Points

  • New Architecture adoption mandatory for SDK 55
  • expo-av package removed, use expo-audio/expo-video
  • Claude Code plugin available for automated upgrades

Summary

Expo SDK 55 introduces React Native 0.83.2 and React 19.2 support, but requires New Architecture adoption as Old Architecture support has been discontinued. The upgrade includes significant package changes and new tooling recommendations.

Key Points

  • New Architecture mandatory: SDK 54 was the last to support Old Architecture
  • Package migration required: expo-av removed, replaced by expo-audio and expo-video
  • Hermes v1 available: Opt-in performance improvements with potential build time trade-offs
  • Development builds recommended: Better upgrade experience than Expo Go dependency
  • Claude Code integration: New AI-powered upgrade assistance via /plugin install upgrading-expo
  • Staged upgrade approach: Migrate to New Architecture on SDK 54 first, then upgrade to SDK 55
  • Transition period: Expo Go remains on SDK 54 temporarily for consistency

Migration Steps

  1. Upgrade to New Architecture on SDK 54
  2. Test thoroughly with development builds
  3. Upgrade to SDK 55 after New Architecture is stable
  4. Replace expo-av usage with expo-audio/expo-video
  5. Consider enabling Hermes v1 for performance gains

Full Translation

Translations

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

claudejamodel: claude-sonnet-4-20250514

Expo SDK 55へのアップグレード方法

Expo SDK 55へのアップグレード方法

Expo SDK 55がリリースされました。React Native 0.83.2とReact 19.2をサポートしています。SDK 54と同様に、Android API level 36とXcode 16.1以上がサポートされています。また、最小サポートOSも変更されておらず、SDK 55はAndroid 7+とiOS 15.1以上向けのアプリをビルドできます。

含まれる全ての内容についてはchangelogをご確認ください。

SDK 55アップグレード時の重要なポイント

React Native Old Architectureのサポート終了

SDK 54 / React Native 0.81がOld Architectureをサポートする最後のバージョンでした。SDK 55を採用する場合、まだ移行していなければNew Architectureも採用する必要があります。SDK 53ではすでにデフォルトに設定されているため、ほとんどのアプリは既にアップグレード済みです。

Claude Codeを活用したSDKアップグレード

Expoでは日常業務でClaude Codeを使用しています。私たちの経験に基づいて、expo/skills libraryでExpoアプリの一般的なタスクを支援するスキルを公開しています。その中の一つが最新のExpo SDKバージョンへのアップグレード用のスキルです。

Claude Codeのターミナルで以下を実行してください:

/plugin marketplace add expo/skills

スキルマーケットプレイスをClaudeに追加し、次に:

/plugin install upgrading-expo

アップグレードスキルをインストールします。

デフォルトプロジェクトとExpo Goの移行期間

App StoreとPlay StoreのExpo Goは、このリリース後しばらくの間SDK 54のままとなり、npx create-expo-appで作成されるデフォルトプロジェクトも一貫性のためSDK 54を使用し続けます。

この移行期間を利用して、プロジェクトをdevelopment buildの使用に移行することをお勧めします。

expo-av → expo-video / expo-audio

SDK 55では、expo-avパッケージが削除されました。以前のSDKでは、その機能を新しく改良されたexpo-audioexpo-videoで段階的に置き換えてきたため、代わりにそれらを使用するようにコードをアップグレードしてください。

パフォーマンス向上のためのHermes v1の試用

新しいHermes v1コンパイラは意味のあるパフォーマンス向上を提供する可能性があり、アプリで試してみる価値があります。SDK 55ではオプトインです。このバージョンでは、プリコンパイルされたバイナリの代わりにReact Nativeをソースからビルドする必要があるため、場合によってはビルド時間が遅くなる可能性があります。

Expo SDKアップグレードのヒント

changelogを確認する

ほとんどのSDKリリースには、既知の破壊的変更や、アプリ固有のシナリオで設定を調整する必要がある可能性のある注目すべき変更のリストがあります。changelogと破壊的変更を読む最適なタイミングはアップグレード前ですが、次に良いタイミングはアップグレード後、特にコンパイルエラーやクラッシュが発生した場合です。

Expo GoよりもDevelopment Buildsを使用する

アップグレードは急いで完了する必要がないときに行うのが最適です。Development buildsは、進行中の機能作業を中断することなくアップグレードに取り組む時間と余裕を与えてくれます。

Development buildはExpo Goと同様に動作し、QRコードをスキャンして再ビルドすることなくローカルでコードを作業できます。しかし、それはあなた自身のアプリなので、新しいバージョンのExpo Goがリリースされてもアップグレードされません。

New Architectureのアドバイス

Expo SDK 54はOld Architectureをサポートする最後のSDKでした。SDK 55 / React Native 0.83はNew Architectureのみをサポートします。

重要: Expo SDKのアップグレードとNew Architectureの採用を同時に行わないでください。これにより問題の特定が困難になります。

推奨手順:

  1. まずSDK 54でNew Architectureにアップグレードし、development buildを作成
  2. テストを実行し、問題があればNew Architectureトラブルシューティングガイドを使用
  3. New Architectureでの動作を確認後、SDK 55にアップグレードして新しいdevelopment buildを作成

トラブルシューティングガイドを確認する

問題に応じて参照できる最も人気のあるトラブルシューティングガイドのランディングページがあります。ビルド時のエラーの場合は、クラッシュやパフォーマンスの問題とは異なる手順を取る必要があります。

サポートが必要な場合

バグレポートやフィードバックをお待ちしています!問題を報告する最良の方法は、npx create-expo-appで作成されたデフォルトプロジェクトテンプレートに基づくGithubリポジトリのリンクと、問題を再現するのに十分なコードを含むminimal reproduction付きのGithub issueです。

また、Discord、Reddit、Blueskyなどでの問題についての議論も歓迎します。詳細なフィードバックについては、サポートページからのメッセージもいつでもチェックしています。

アップグレードを楽しんで、SDK 55を気に入っていただけることを願っています!

How to upgrade to Expo SDK 55 | Expo | DocsDigest