EAS Workflows 中的预打包作业

name: Build iOS app

on:
  push:
    branches: ['main']

jobs:
  build_ios:
    name: Build iOS
    type: build
    params:
      platform: ios
      profile: production

name: Build for all platforms

on:
  push:
    branches: ['main']

jobs:
  build_android:
    name: Build Android
    type: build
    params:
      platform: android
      profile: production

  build_ios:
    name: Build iOS
    type: build
    params:
      platform: ios
      profile: production

name: 使用环境变量构建

on:
  push:
    branches: ['main']

jobs:
  build_android:
    name: Build Android
    type: build
    env:
      APP_ENV: production
      API_URL: https://api.example.com
    params:
      platform: android
      profile: production

name: 使用不同配置文件构建

on:
  push:
    branches: ['main']

jobs:
  build_android_development:
    name: Build Android Development
    type: build
    params:
      platform: android
      profile: development

  build_android_production:
    name: Build Android Production
    type: build
    params:
      platform: android
      profile: production

name: Build iOS internal

on:
  push:
    branches: ['main']

jobs:
  build_ios:
    name: Build iOS Internal
    type: build
    params:
      platform: ios
      profile: preview
      refresh_ad_hoc_provisioning_profile: true

name: Basic Deployment

jobs:
  deploy:
    name: Deploy to Production
    type: deploy
    params:
      prod: true

name: Deploy

on:
  push:
    branches: ['*']

jobs:
  deploy:
    name: Deploy
    type: deploy
    params:
      prod: ${{ github.ref_name == 'main' }}

name: Deployment with Alias

jobs:
  deploy:
    name: Deploy with Alias
    type: deploy
    params:
      alias: my-custom-alias
      prod: true

name: 基础指纹

jobs:
  fingerprint:
    name: 计算指纹
    type: fingerprint
    environment: production

name: 使用环境变量的指纹

jobs:
  fingerprint:
    name: 计算指纹
    type: fingerprint
    environment: production
    # 结果环境将是 "production" 环境与内联环境变量的并集。
    # `env` 变量会覆盖 "production" 环境中同名的环境变量。
    env:
      APP_VARIANT: staging
      API_URL: https://api.staging.example.com

name: 获取生产构建

jobs:
  get_build:
    name: 获取最新生产构建
    type: get-build
    params:
      platform: ios
      profile: production
      distribution: store
      channel: production

name: 按版本获取构建

jobs:
  get_build:
    name: 获取特定版本构建
    type: get-build
    params:
      platform: android
      app_identifier: com.example.app
      app_version: 1.0.0
      app_build_version: 42

name: 获取模拟器构建

jobs:
  get_build:
    name: 获取模拟器构建
    type: get-build
    params:
      platform: ios
      simulator: true
      profile: development
      wait_for_in_progress: true

name: 提交 iOS 构建

jobs:
  build_ios:
    name: 构建 iOS
    type: build
    params:
      platform: ios
      profile: production

  submit:
    name: 提交到 App Store
    type: submit
    needs: [build_ios]
    params:
      build_id: ${{ needs.build_ios.outputs.build_id }}
      profile: production

name: 提交 Android 构建

jobs:
  build_android:
    name: 构建 Android
    type: build
    params:
      platform: android
      profile: production

  submit:
    name: 提交到 Play Store
    type: submit
    needs: [build_android]
    params:
      build_id: ${{ needs.build_android.outputs.build_id }}
      profile: production

name: TestFlight 分发

jobs:
  build_ios:
    name: 构建 iOS
    type: build
    params:
      platform: ios
      profile: production

  testflight:
    name: 分发到 TestFlight
    type: testflight
    needs: [build_ios]
    params:
      build_id: ${{ needs.build_ios.outputs.build_id }}
      internal_groups: ['QA Team']
      external_groups: ['Public Beta']
      changelog: |
        此版本的新内容：
        - 新功能
        - 错误修复

name: TestFlight with Changelog

jobs:
  testflight:
    name: 上传更新日志
    type: testflight
    params:
      build_id: ${{ needs.build_ios.outputs.build_id }}
      changelog: "${{ github.commit_message || '错误修复' }}"
      # github.commit_message 仅在 push 和 schedule 事件中可用。

name: Distribute to TestFlight after ASC upload

on:
  app_store_connect:
    build_upload:
      states:
        - complete

jobs:
  distribute_to_testflight:
    name: Distribute to TestFlight
    type: testflight
    params:
      asc_build_id: ${{ app_store_connect.build_upload.build.id }}
      internal_groups:
        - QA Team
      external_groups:
        - Public Beta
      changelog: Build from CI
      submit_beta_review: true

name: Update TestFlight changelog

on:
  workflow_dispatch:
    inputs:
      asc_build_id:
        type: string
        required: true
        description: 要更新的 App Store Connect 构建 ID。
      changelog:
        type: string
        required: true
        description: 新的“要测试的内容”说明。

jobs:
  update_changelog:
    name: Update changelog
    type: testflight
    params:
      asc_build_id: ${{ inputs.asc_build_id }}
      changelog: ${{ inputs.changelog }}
      submit_beta_review: false

name: Update Production

on:
  push:
    branches: ['main']

jobs:
  update_production:
    name: Update Production Channel
    type: update
    params:
      channel: production

name: Platform-specific Updates

on:
  push:
    branches: ['main']

jobs:
  update_android:
    name: Update Android
    type: update
    params:
      platform: android
      channel: production

  update_ios:
    name: Update iOS
    type: update
    params:
      platform: ios
      channel: production

name: 基于分支的更新

on:
  push:
    branches: ['main', 'staging']

jobs:
  update_branch:
    name: 按分支更新
    type: update
    params:
      branch: ${{ github.ref_name }}
      message: '分支更新：${{ github.ref_name }}'

name: Update with sourcemaps

on:
  push:
    branches: ['main']

jobs:
  update:
    name: Publish update
    type: update
    params:
      channel: production
    hooks:
      after_update:
        - uses: eas/posthog_upload_sourcemaps

name: 分阶段发布更新

on:
  push:
    branches: ['main']

jobs:
  publish_update:
    name: 将更新发布给 25% 的用户
    type: update
    params:
      channel: production
      rollout_percentage: 25

  require_approval:
    name: 发布给所有用户？
    type: require-approval
    needs: [publish_update]

  complete_rollout:
    name: 发布给所有用户
    type: update-rollout
    needs: [publish_update, require_approval]
    params:
      update_group_id: ${{ needs.publish_update.outputs.first_update_group_id }}
      rollout_percentage: 100

name: Basic Maestro Test

jobs:
  test:
    name: 运行 Maestro 测试
    type: maestro
    environment: preview
    params:
      build_id: ${{ needs.build_ios_simulator.outputs.build_id }}
      flow_path: ./maestro/flows

name: Sharded Maestro Test

jobs:
  test:
    name: 运行分片 Maestro 测试
    type: maestro
    environment: preview
    runs_on: linux-large-nested-virtualization
    params:
      build_id: ${{ needs.build_android_emulator.outputs.build_id }}
      flow_path: ./maestro/flows
      shards: 3
      retries: 2

name: Basic Maestro Test

jobs:
  test:
    name: Run Maestro Tests
    type: maestro
    env:
      MAESTRO_APP_ID: 'com.yourhost.yourapp'
    params:
      build_id: ${{ needs.build_ios_simulator.outputs.build_id }}

name: Maestro Hooks

jobs:
  test:
    name: Run Maestro Tests
    type: maestro
    environment: preview
    params:
      build_id: ${{ needs.build_ios_simulator.outputs.build_id }}
      flow_path: ./maestro_tests
    hooks:
      before_maestro_tests:
        - name: 生成 Maestro flows
          run: npx tsx scripts/generate-maestro-tests.ts

name: Pixel E2E Test

jobs:
  test:
    name: Run Maestro Tests
    type: maestro
    runs_on: linux-large-nested-virtualization
    params:
      build_id: ${{ needs.build_android_emulator.outputs.build_id }}
      device_identifier: 'pixel_6'
      record_screen: true
      android_system_image_package: 'system-images;android-35;default;x86_64'

appId: com.myapp
---
- launchApp
- startRecording: ${MAESTRO_TESTS_DIR}/my_recording
- takeScreenshot: ${MAESTRO_TESTS_DIR}/my_screenshot
- tapOn: '登录按钮'
- takeScreenshot: ${MAESTRO_TESTS_DIR}/after_login_screenshot
- stopRecording

name: Maestro Artifact Reporting

jobs:
  test:
    name: Run Maestro Tests
    type: maestro
    environment: preview
    env:
      SLACK_WEBHOOK_URL: ${{ env.SLACK_WEBHOOK_URL }}
    params:
      build_id: ${{ needs.build_ios_simulator.outputs.build_id }}
      flow_path: ./maestro/flows
      record_screen: true
    hooks:
      after_maestro_tests:
        - name: Report Maestro artifacts
          run: npx tsx scripts/report-maestro-artifacts.ts "$MAESTRO_TESTS_DIR"

name: 基础 Maestro 测试

jobs:
  test:
    name: 运行 Maestro 测试
    type: maestro-cloud
    environment: preview
    params:
      build_id: ${{ needs.build_ios_simulator.outputs.build_id }}
      maestro_project_id: proj_01jw6hxgmdffrbye9fqn0pyzm0
      flows: ./maestro/flows

name: 基础 Maestro 测试

jobs:
  test:
    name: 运行 Maestro 测试
    type: maestro-cloud
    env:
      MAESTRO_APP_ID: 'com.yourhost.yourapp'
    params:
      build_id: ${{ needs.build_ios_simulator.outputs.build_id }}
      maestro_project_id: proj_01jw6hxgmdffrbye9fqn0pyzm0
      flows: ./maestro/flows

name: 带通知的 Maestro Cloud

jobs:
  maestro_test:
    name: 运行 Maestro Cloud 测试
    type: maestro-cloud
    environment: preview
    params:
      build_id: ${{ needs.build.outputs.build_id }}
      maestro_project_id: proj_xyz
      flows: ./maestro/flows

  notify:
    name: 发送测试结果
    after: [maestro_test]
    type: slack
    environment: production
    params:
      webhook_url: ${{ env.SLACK_WEBHOOK_URL }} # 确保在正确的环境中进行设置（见上方 "environment: ..."）
      message: '测试完成：${{ after.maestro_test.outputs.successful_flows_count }}/${{ after.maestro_test.outputs.total_flows_count }} 通过'

name: Build Notification

jobs:
  build_ios:
    name: Build iOS
    type: build
    params:
      platform: ios
      profile: production

  notify_build:
    name: 通知构建状态
    needs: [build_ios]
    type: slack
    environment: production
    params:
      webhook_url: ${{ env.SLACK_WEBHOOK_URL }}
      message: '为应用 ${{ needs.build_ios.outputs.app_identifier }}（版本 ${{ needs.build_ios.outputs.app_version }}）完成构建'

name: Rich Build Notification

jobs:
  build_android:
    name: Build Android
    type: build
    params:
      platform: android
      profile: production

  notify_build:
    name: 通知构建状态
    needs: [build_android]
    type: slack
    environment: production
    params:
      webhook_url: ${{ env.SLACK_WEBHOOK_URL }}
      payload:
        blocks:
          - type: header
            text:
              type: plain_text
              text: '构建已完成'
          - type: section
            fields:
              - type: mrkdwn
                text: "*应用:*\n${{ needs.build_android.outputs.app_identifier }}"
              - type: mrkdwn
                text: "*版本:*\n${{ needs.build_android.outputs.app_version }}"
          - type: section
            fields:
              - type: mrkdwn
                text: "*构建 ID:*\n${{ needs.build_android.outputs.build_id }}"
              - type: mrkdwn
                text: "*平台:*\n${{ needs.build_android.outputs.platform }}"
          - type: section
            text:
              type: mrkdwn
              text: '分发：${{ needs.build_android.outputs.distribution }}'

name: PR 自动评论

on:
  pull_request: {}

jobs:
  # ...

  comment_on_pr:
    name: 在 PR 中发布结果
    after: [build_ios, build_android, publish_update, deploy]
    type: github-comment
    # 无需 params - 自动发现所有构建、更新和部署

name: PR 自定义消息

on:
  pull_request: {}

jobs:
  # ...

  comment_on_pr:
    name: 在 PR 中发布构建结果
    after: [build_ios, build_android, publish_update, deploy]
    type: github-comment
    params:
      message: '🎉 预览构建已就绪！请在批准 PR 之前测试这些更改。'
      # build_ids、update_group_ids 和 deployment_ids 未定义，因此已启用自动发现

name: PR 预览

on:
  pull_request: {}

jobs:
  deploy:
    type: deploy
    name: 部署 PR 预览

  comment:
    needs: [deploy]
    type: github-comment

name: PR 指定构建

on:
  pull_request: {}

jobs:
  # ...

  comment_update:
    name: 在 PR 中发布更新
    after: [build_ios, build_android, publish_update]
    type: github-comment
    params:
      message: '等待 QA 审查的测试构建已就绪'
      build_ids:
        - ${{ after.build_ios.outputs.build_id }}
        - ${{ after.build_android.outputs.build_id }}
      update_group_ids:
        - ${{ after.publish_update.outputs.first_update_group_id }}

name: 仅更新 PR

on:
  pull_request: {}

jobs:
  # ...

  comment_updates_only:
    name: 仅发布更新
    after: [publish_update]
    type: github-comment
    params:
      message: '有新的更新可供测试！'
      build_ids: [] # 空数组会排除所有构建
      deployment_ids: [] # 空数组会排除所有部署
      # update_group_ids 未定义 = 自动发现更新

name: 自定义 PR 评论

on:
  pull_request: {}

jobs:
  # ...

  custom_comment:
    name: 发布自定义评论
    needs: [build_ios]
    type: github-comment
    params:
      # Payload 模式：完全控制内容
      # 不能将 message、build_ids 或 update_group_ids 与 payload 一起使用
      payload: |
        ## 🚀 构建状态更新

        ### iOS 构建已完成
        - **构建 ID**: `${{ needs.build_ios.outputs.build_id }}`
        - **版本**: ${{ needs.build_ios.outputs.app_version }}
        - **构建号**: ${{ needs.build_ios.outputs.app_build_version }}

        ### 下一步
        1. 从 [EAS Dashboard](https://expo.dev/accounts/[account]/projects/[project]/builds/${{ needs.build_ios.outputs.build_id }}) 下载构建
        2. 在实体设备上测试
        3. 批准以进行 TestFlight 分发

        ---
        *此评论由 EAS Workflows 自动生成*

name: 条件 PR 评论

on:
  pull_request: {}

jobs:
  build_android:
    name: 构建 Android
    type: build
    params:
      platform: android
      profile: preview

  comment_success:
    name: 发布成功评论
    needs: [build_android]
    if: ${{ needs.build_android.status == 'success' }}
    type: github-comment
    params:
      message: '✅ Android 构建成功！可供测试。'
      build_ids: # 仅为说明目的提供，你也可以在这里省略它
        - ${{ needs.build_android.outputs.build_id }}

  comment_failure:
    name: 发布失败评论
    after: [build_android]
    if: ${{ after.build_android.status == 'failure' }}
    type: github-comment
    params:
      payload: |
        ❌ **Android 构建失败**

        请查看 [工作流日志](https://expo.dev/accounts/[account]/projects/[project]/workflows) 以获取详情。

name: Register iOS device and notify Slack

jobs:
  register_device:
    type: apple-device-registration-request
    params:
      apple_team_identifier: XX33YYZ44Z
  notify_slack:
    needs: [register_device]
    type: slack
    environment: production
    params:
      webhook_url: ${{ env.SLACK_WEBHOOK_URL }}
      message: 'Registered device ${{ needs.register_device.outputs.identifier }} (${{ needs.register_device.outputs.model }})'

name: Register device and build iOS internal

jobs:
  register_device:
    type: apple-device-registration-request
    params:
      apple_team_identifier: ABCDE12345
  build_ios:
    needs: [register_device]
    type: build
    params:
      platform: ios
      profile: preview
      refresh_ad_hoc_provisioning_profile: true

jobs:
  web_preview:
    name: 部署 Web 预览版
    type: deploy

  require_approval:
    name: 将 Web 部署到生产环境？
    needs: [web_preview]
    type: require-approval

  web_production:
    name: 部署 Web 生产版
    needs: [require_approval]
    type: deploy
    params:
      prod: true

jobs:
  show_story_intro:
    name: 龙与骑士故事开场
    type: doc
    params:
      md: |
        # 龙与骑士

        很久以前，在一个遥远的国度里，一位勇敢的骑士踏上征程，去面对一条强大的巨龙。

        巨龙咆哮着，向山谷喷吐火焰，但骑士坚定不移，高举盾牌。

        现在，他们这场相遇的命运掌握在你手中……

  require_approval:
    name: 骑士和巨龙应该成为朋友吗？
    needs: [show_story_intro]
    type: require-approval

  happy_ending:
    name: 友谊结局
    needs: [require_approval]
    type: doc
    params:
      md: |
        ## 一段新的友谊

        骑士放下了剑，巨龙也停止了喷火。他们意识到彼此都渴望和平。从那天起，他们成为了最好的朋友，一起守护王国。

  epic_battle:
    name: 史诗战斗结局
    after: [require_approval]
    if: ${{ failure() }}
    type: doc
    params:
      md: |
        ## 史诗之战

        骑士向前冲锋，巨龙发出震天怒吼。他们的战斗震动了群山，并在岁月中回响。最终，他们都被铭记为凶猛而高贵的对手。

jobs:
  build_ios:
    name: 构建 iOS
    type: build
    params:
      platform: ios
      profile: production

  submit:
    name: 提交到 App Store
    type: submit
    needs: [build_ios]
    params:
      build_id: ${{ needs.build_ios.outputs.build_id }}
      profile: production

  next_steps:
    name: 后续步骤
    needs: [submit]
    type: doc
    params:
      md: |
        # 接下来要做什么

        你的应用刚刚已发送到 [App Store Connect](https://appstoreconnect.apple.com/apps)。

        1. 从 TestFlight 下载应用。
        2. 充分测试应用。
        3. 提交应用进行审核。

name: continuous-deploy-fingerprint

jobs:
  fingerprint:
    id: fingerprint
    type: fingerprint
    environment: production

  android_get_build:
    needs: [fingerprint]
    id: android_get_build
    type: get-build
    params:
      fingerprint_hash: ${{ needs.fingerprint.outputs.android_fingerprint_hash }}
      platform: android

  android_repack:
    needs: [android_get_build]
    id: android_repack
    if: ${{ needs.android_get_build.outputs.build_id }}
    type: repack
    params:
      build_id: ${{ needs.android_get_build.outputs.build_id }}

  android_build:
    needs: [android_get_build]
    id: android_build
    if: ${{ !needs.android_get_build.outputs.build_id }}
    type: build
    params:
      platform: android
      profile: preview-simulator

  android_maestro:
    after: [android_repack, android_build]
    id: android_maestro
    type: maestro
    image: latest
    params:
      build_id: ${{ needs.android_repack.outputs.build_id || needs.android_build.outputs.build_id }}
      flow_path: ['maestro.yaml']

  ios_get_build:
    needs: [fingerprint]
    id: ios_get_build
    type: get-build
    params:
      fingerprint_hash: ${{ needs.fingerprint.outputs.ios_fingerprint_hash }}
      platform: ios

  ios_repack:
    needs: [ios_get_build]
    id: ios_repack
    if: ${{ needs.ios_get_build.outputs.build_id }}
    type: repack
    params:
      build_id: ${{ needs.ios_get_build.outputs.build_id }}

  ios_build:
    needs: [ios_get_build]
    id: ios_build
    if: ${{ !needs.ios_get_build.outputs.build_id }}
    type: build
    params:
      platform: ios
      profile: preview-simulator

  ios_maestro:
    after: [ios_repack, ios_build]
    id: ios_maestro
    type: maestro
    image: latest
    params:
      build_id: ${{ needs.ios_repack.outputs.build_id || needs.ios_build.outputs.build_id }}
      flow_path: ['maestro.yaml']