如何用YAML配置GitHub Actions为macOS应用运行Xcode测试？

现有配置的故障点梳理 #

• YAML语法类故障
  • 顶级字段缩进错误：原配置中on:行前存在多余前置空格，会导致整个工作流无法被GitHub解析识别，所有顶级配置项（name、on、jobs）必须无额外行首缩进。
  • 非法触发事件：GitHub Actions没有内置merge事件，原有on: [push, merge]的写法无法通过事件合法性校验。
  • 无效空步骤：Execute full install步骤仅声明了名称，没有绑定实际执行的命令或动作，会触发步骤配置报错。
• 功能适配类故障
  • 动作版本过旧：actions/checkout@v1已停止维护，对现代大体积Git仓库、子模块的兼容能力不足。
  • 必填参数缺失：使用的xcodebuild动作没有传入项目路径、Scheme名称等核心参数，运行时无法定位Xcode工程，自然无法完成构建和测试。
  • 触发逻辑不匹配：受平台安全隔离规则限制，源仓库的GitHub Actions默认不会直接监听外部Fork仓库的push事件；如果要实现Fork开发者推送代码时自动触发测试，需要基于pull_request事件关联对应Fork分支的变更——开发者每次向自己的Fork分支推送代码，关联的提PR页面就会自动更新，并触发CI流程运行。

可直接落地的修正配置 #

name: Smoke Test CI

on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main, develop ]

jobs:
  build:
    runs-on: macOS-latest
    steps:
      - name: Checkout source code
        uses: actions/checkout@v4
      - name: Install project dependencies
        run: |
          # 如项目使用CocoaPods，可在此处添加 pod install 命令
          # 如项目使用Carthage，可在此处添加 carthage bootstrap 命令
      - name: Xcode build and unit test
        uses: sersoft-gmbh/xcodebuild-action@v1.3
        with:
          # 替换为实际的工程路径，如 MyApp.xcworkspace
          project: MyApp.xcodeproj
          # 替换为项目中已开启共享的Scheme名称
          scheme: MyApp
          # 指定执行测试动作
          action: test
          # 指定测试目标为macOS平台
          destination: platform=macOS

上线前校验要点 #

• 项目对应的Scheme需要在Xcode中勾选Shared选项，否则CI环境下xcodebuild无法自动识别到可用的测试目标。
• 如果项目依赖私有SPM源、内部Pod库，需要在拉取依赖的步骤中配置对应的访问权限凭证，否则依赖拉取会中断。

内容的提问来源于stack exchange，提问作者ScottyBlades