mcpField
E
expo-deployment

expo-deployment

github.com/expo云与 DevOps3.5k40.2k 次安装今天更新
代码仓库

关于 expo-deployment

面向 Expo 应用开发者的部署技能,指导使用 EAS 为 iOS、Android 和 Web 构建并发布应用。还涵盖商店提交、版本管理与自动化部署。

主要功能

  1. 01构建 iOS 和 Android 应用
  2. 02提交至 App Store 和 Google Play
  3. 03部署 Web 应用和 PR 预览
  4. 04管理版本与构建状态
  5. 05配置 EAS 自动化工作流

适用场景

  1. 01发布 iOS 测试版或正式版
  2. 02提交 Android 应用至 Google Play
  3. 03部署 Web 版本并生成 PR 预览
  4. 04检查构建和提交状态

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/expo/skills --skill expo-deployment

安装后在 Claude Code 中输入/expo-deployment确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
app-store-metadata.md
ios-app-store.md
play-store.md
testflight.md
workflows.md

详细介绍

部署

此技能介绍如何使用 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 提交与审核流程

快速入门

安装 EAS CLI
npm install -g eas-cli
eas login
初始化 EAS
npx eas-cli@latest init

这会创建包含构建配置的 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 --submit

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

# Shortcut for iOS TestFlight
npx testflight

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 包一起部署到 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
  • 使用 npx testflight 快速提交到 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 技能——它依据实时工作流架构运行。

版本管理

EAS 通过 appVersionSource: "remote" 自动管理版本号:

# Check current versions
eas build:version:get

# Manually set version
eas build:version:set -p ios --build-number 42

监控

# List recent builds
eas build:list

# Check build status
eas build:view

# View submission status
eas submit:list

评论

支持 Markdown