expo-deployment

部署

适用场景

当你需要使用 EAS 将 Expo 应用部署到生产环境时，请使用此技能 — 构建并提交到 iOS App Store、Google Play Store 和 TestFlight，配置 eas.json 构建与提交配置，管理应用版本和构建号，发布 App Store 元数据并进行 ASO 优化，以及通过 EAS 部署 Web bundle 和 API 路由……

此技能涵盖使用 EAS（Expo Application Services）在所有平台上部署 Expo 应用。

参考资料

根据需要查阅以下资源：

• ./references/workflows.md -- 自动部署和 PR 预览的 CI/CD 工作流
• ./references/testflight.md -- 提交 iOS 构建版本到 TestFlight 进行 Beta 测试
• ./references/app-store-metadata.md -- 管理 App Store 元数据并优化 ASO
• ./references/play-store.md -- 提交 Android 构建版本到 Google Play Store
• ./references/ios-app-store.md -- iOS App Store 提交与审核流程

在开始云端构建、提交、推送元数据或部署之前，请确认具体的项目／账户、构建产物、发布轨道／频道和费用。先准备好配置；发布操作必须在用户授权范围内进行。自动化时应固定使用经过审核的 CLI 版本，不要使用浮动的 @latest。

快速入门

安装 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 路由会随 Web bundle 一起部署到 EAS Hosting — 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

• 使用 eas build -p ios --profile production --auto-submit 快速提交到 TestFlight
• 通过 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 技能 — 它依据实时工作流架构运行。

版本管理

使用 appVersionSource: "remote" 时，EAS 会自动管理版本号：

# 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 行为、定价、配额、凭据和部署影响。
• 不要将生成的示例视为环境专属测试、安全审查或对破坏性或高成本操作取得用户批准的替代品。