expo-deployment

デプロイ

使用する場面

EAS を使用して Expo アプリを本番環境にデプロイする必要がある場合に、このスキルを使用します。iOS App Store、Google Play Store、TestFlight 向けのビルドと提出、eas.json のビルドおよび提出プロファイルの設定、アプリのバージョンとビルド番号の管理、App Store のメタデータと ASO の公開、EAS 経由での Web バンドルと API ルートのデプロイなどを行います。

このスキルでは、EAS（Expo Application Services）を使用して、すべてのプラットフォームに Expo アプリケーションをデプロイします。

参考資料

必要に応じて、以下のリソースを参照してください。

• ./references/workflows.md -- 自動デプロイと PR プレビューのための CI/CD ワークフロー
• ./references/testflight.md -- ベータテスト用の iOS ビルドを TestFlight に提出する方法
• ./references/app-store-metadata.md -- App Store のメタデータと ASO 最適化の管理
• ./references/play-store.md -- Android ビルドを Google Play Store に提出する方法
• ./references/ios-app-store.md -- iOS App Store の提出と審査プロセス

クラウドビルド、提出、メタデータのプッシュ、デプロイの前に、対象のプロジェクト／アカウント、成果物、トラック／チャンネル、費用を確認してください。まず設定を準備し、公開はユーザーが許可した範囲内で行ってください。自動化では、変動する @latest ではなく、レビュー済みの CLI バージョンを固定してください。

クイックスタート

EAS CLI をインストールする

npm install -g eas-cli
eas login

EAS を初期化する

npx eas-cli@latest init

eas init は EAS プロジェクトをリンクまたは作成します。eas build:configure を実行してビルドプロファイルを設定し、生成された eas.json を確認してください。

ビルドコマンド

本番ビルド

# iOS App Store build
npx eas-cli@latest build -p ios --profile production

# Android Play Store build
npx eas-cli@latest build -p android --profile production

# Both platforms
npx eas-cli@latest build --profile production

ストアに提出する

# iOS: Build and submit to App Store Connect
npx eas-cli@latest build -p ios --profile production --auto-submit

# Android: Build and submit to Play Store
npx eas-cli@latest build -p android --profile production --auto-submit

# Shortcut for iOS TestFlight
eas build -p ios --profile production --auto-submit

Web デプロイ

EAS Hosting を使用して Web アプリをデプロイします。

# Deploy to production
npx expo export -p web
npx eas-cli@latest deploy --prod

# Deploy PR preview
npx eas-cli@latest deploy

Expo Router の API ルートは、EAS Hosting で Web バンドルと一緒にデプロイされます。eas deploy は両方をデプロイします。API ルート自体を作成または設定する場合は、expo-api-routes スキルを使用してください。

EAS の設定

本番デプロイ用の標準的な eas.json：

{
  "cli": {
    "version": ">= 16.0.1",
    "appVersionSource": "remote"
  },
  "build": {
    "production": {
      "autoIncrement": true,
      "ios": {
        "resourceClass": "m-medium"
      }
    },
    "development": {
      "developmentClient": true,
      "distribution": "internal"
    }
  },
  "submit": {
    "production": {
      "ios": {
        "appleId": "[email protected]",
        "ascAppId": "1234567890"
      },
      "android": {
        "serviceAccountKeyPath": "./google-service-account.json",
        "track": "internal"
      }
    }
  }
}

プラットフォーム別ガイド

iOS

• 手軽に TestFlight へ提出するには、eas build -p ios --profile production --auto-submit を使用します
• eas credentials で Apple の認証情報を設定します
• 認証情報の設定については、./references/testflight.md を参照してください
• App Store への提出については、./references/ios-app-store.md を参照してください

Android

• Google Play Console のサービスアカウントを設定します
• トラックを設定します：internal → closed → open → production
• 詳細な設定方法については、./references/play-store.md を参照してください

Web

• EAS Hosting は PR 用のプレビュー URL を提供します
• 本番環境へのデプロイはカスタムドメインに行われます
• CI/CD の自動化については、./references/workflows.md を参照してください

自動デプロイ

EAS Workflows は、CI/CD のビルド → 提出 → 更新 → デプロイのパイプラインを自動化します。デプロイ向けの例については、./references/workflows.md を参照してください。ワークフロー YAML を作成または検証する場合は、ライブのワークフロースキーマに基づいて動作する expo-cicd-workflows スキルを使用してください。

バージョン管理

EAS は appVersionSource: "remote" により、バージョン番号を自動的に管理します。

# Check current versions
eas build:version:get

# Manually set version
eas build:version:set -p ios  # interactive; verify selected project/value

モニタリング

# List recent builds
eas build:list

# Check build status
eas build:view

# View submission status
# Inspect the exact submission in the EAS project dashboard

制限事項

• このスキルは、タスクが上流製品または API の対象範囲に明確に合致する場合にのみ使用してください。
• 変更を加える前に、コマンド、API の動作、料金、クォータ、認証情報、デプロイによる影響を、最新の公式ドキュメントで確認してください。
• 生成された例を、環境固有のテスト、セキュリティレビュー、または破壊的な操作や高額な操作に対するユーザーの承認の代わりとして扱わないでください。