Deployment

参考文档

根据需要查阅以下资源：

• ./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 构建
npx eas-cli@latest build -p ios --profile production

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

# 两个平台
npx eas-cli@latest build --profile production

提交到应用商店

# iOS：构建并提交到 App Store Connect
npx eas-cli@latest build -p ios --profile production --submit

# Android：构建并提交到 Play Store
npx eas-cli@latest build -p android --profile production --submit

# iOS TestFlight 快捷方式
npx testflight

Web 部署

使用 EAS Hosting 部署 Web 应用：

# 部署到生产环境
npx expo export -p web
npx eas-cli@latest deploy --prod

# 部署 PR 预览
npx eas-cli@latest deploy

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": "your@email.com",
        "ascAppId": "1234567890"
      },
      "android": {
        "serviceAccountKeyPath": "./google-service-account.json",
        "track": "internal"
      }
    }
  }
}

平台特定指南

iOS

• 使用 npx testflight 快速提交到 TestFlight
• 通过 eas credentials 配置 Apple 凭证
• 查看 ./reference/testflight.md 了解凭证设置
• 查看 ./reference/ios-app-store.md 了解 App Store 提交流程

Android

• 设置 Google Play Console 服务账号
• 配置发布轨道：内部测试 → 封闭测试 → 开放测试 → 生产
• 查看 ./reference/play-store.md 了解详细设置

Web

• EAS Hosting 为 PR 提供预览 URL
• 生产环境部署到您的自定义域名
• 查看 ./reference/workflows.md 了解 CI/CD 自动化

自动化部署

使用 EAS Workflows 实现 CI/CD：

# .eas/workflows/release.yml
name: 发布

on:
  push:
    branches: [main]

jobs:
  build-ios:
    type: build
    params:
      platform: ios
      profile: production

  submit-ios:
    type: submit
    needs: [build-ios]
    params:
      platform: ios
      profile: production

更多工作流示例请查看 ./reference/workflows.md。

版本管理

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

# 查看当前版本
eas build:version:get

# 手动设置版本
eas build:version:set -p ios --build-number 42

监控

# 列出最近的构建
eas build:list

# 检查构建状态
eas build:view

# 查看提交流程状态
eas submit:list