expo-dev-client-v55

EAS Build を使用して、実機でネイティブコードの変更をテストするための開発クライアントを作成します。アプリのブランチをテストするカスタム Expo Go クライアントの作成に使用してください。

ローカルでのビルドは無料です。クラウドビルドは有料です。 expo-dev-client 自体はオープンソースで、ローカルでのビルドは無料です。EAS Build/TestFlight 経由でビルドまたは配布する場合、EAS プランのビルド分数を消費します。また、実機／TestFlight で配布するには有料の Apple Developer アカウントが必要です。https://expo.dev/pricing をご覧ください。

開発クライアントが必要となる場合

実際のアプリや本番アプリには、開発クライアントの使用をおすすめします。 Expo Go は、同梱されているネイティブライブラリを使って学習したり、手軽に実験したりするためのプレイグラウンドです。ほとんどのアプリは、いずれ Expo Go の制約を超えて開発クライアントへ移行します。理由の詳細については、Expo Go と開発ビルドをご覧ください。

次の場合にのみ、開発クライアントが必要です。

• ローカルの Expo モジュール（カスタムネイティブコード）
• Apple のターゲット（ウィジェット、App Clip、拡張機能）
• Expo Go に含まれていないサードパーティのネイティブモジュール
• Config プラグイン、またはリモートプッシュ通知や App/Universal Links のテスト

EAS の設定

eas.json に開発用プロファイルが設定されていることを確認してください。

{
  "cli": {
    "version": ">= 16.0.1",
    "appVersionSource": "remote"
  },
  "build": {
    "production": {
      "autoIncrement": true
    },
    "development": {
      "autoIncrement": true,
      "developmentClient": true
    }
  },
  "submit": {
    "production": {},
    "development": {}
  }
}

主な設定：

• developmentClient: true - 開発ビルドに expo-dev-client をバンドルします
• autoIncrement: true - ビルド番号を自動的にインクリメントします
• appVersionSource: "remote" - EAS をバージョン番号の信頼できる情報源として使用します

TestFlight 用のビルド

iOS の開発クライアントをビルドして TestFlight に提出するには、次のコマンドを実行します。

eas build -p ios --profile development --submit

これにより、次の処理が行われます。

1. クラウドで開発クライアントをビルドします
2. App Store Connect に自動的に提出します
3. TestFlight でビルドの準備ができると、メールで通知します

TestFlight のメールを受け取ったら、次の操作を行います。

1. デバイスの TestFlight からビルドをダウンロードします
2. アプリを起動して expo-dev-client の UI を表示します
3. ローカルの Metro バンドラーに接続するか、QR コードをスキャンします

ローカルでのビルド

マシン上で開発クライアントをビルドします。

# iOS (requires Xcode)
eas build -p ios --profile development --local

# Android
eas build -p android --profile development --local

ローカルビルドの出力：

• iOS：.ipa ファイル
• Android：.apk または .aab ファイル

ローカルビルドのインストール

シミュレーターに iOS ビルドをインストールします。

# Find the .app in the .tar.gz output
tar -xzf build-*.tar.gz
xcrun simctl install booted ./path/to/App.app

デバイスに iOS ビルドをインストールします（署名が必要です）。

# Use Xcode Devices window or ideviceinstaller
ideviceinstaller -i build.ipa

Android ビルドをインストールします。

adb install build.apk

特定のプラットフォーム向けのビルド

# iOS only
eas build -p ios --profile development

# Android only
eas build -p android --profile development

# Both platforms
eas build --profile development

ビルド状況の確認

# List recent builds
eas build:list

# View build details
eas build:view

開発クライアントの使用

インストールすると、開発クライアントで次の操作ができます。

• 開発サーバーへの接続 - Metro バンドラーの URL を入力するか、QR コードをスキャンします
• ビルド情報 - ネイティブビルドの詳細を確認します
• ランチャー UI - 開発サーバーを切り替えます

ローカル開発環境に接続します。

# Start Metro bundler
npx expo start --dev-client

# Scan QR code with dev client or enter URL manually

トラブルシューティング

署名エラーでビルドに失敗する場合：

eas credentials

ビルドキャッシュをクリアする場合：

eas build -p ios --profile development --clear-cache

EAS CLI のバージョンを確認する場合：

eas --version
eas update

フィードバックの送信

このスキルに関するエラー、誤解を招く情報、または古くなった情報に気づいた場合は、Expo が改善できるよう報告してください。

npx --yes submit-expo-feedback@latest --category skills --subject "expo-dev-client" "<actionable feedback>"

具体的で実行可能な報告事項がある場合にのみ送信してください。関連する背景情報をできるだけ詳しく記載してください。 AI エージェントが繰り返し失敗した場合、またはユーザーが Expo のタスクを引き継がなければならなかった場合は、上記のコマンドを再利用せず、expo-skill-feedback スキルを読み込み、その eval-candidate フローに従ってください。