如何通过CLI编译项目/工作区中的Playground并集成至CI流程

嘿，我来帮你搞定这个Playground的CLI编译和CI集成问题！针对你的场景——工作区里包含PWPCore框架和依赖它的Playground，要把编译步骤放进CI，确保框架改了之后Playground必须同步更新，咱们一步步来：

1. 先搞定本地的CLI编译验证 #

首先得在自己电脑上跑通命令行编译，这样CI里才不会踩坑：

第一步：先构建依赖的PWPCore框架 #

Playground依赖你的框架，所以得先把框架编译通过，用xcodebuild就行：

xcodebuild -workspace PwP.xcworkspace -scheme PWPCore -configuration Debug build

这里的PwP.xcworkspace是你的工作区文件名，PWPCore是框架对应的scheme，你要是命名不一样就改成自己的。

第二步：编译并验证Playground #

接下来就可以处理Playground了。有两种方式：

• 用xcrun playground专门工具编译：

xcrun playground build --workspace PwP.xcworkspace --scheme "你的Playground Scheme名称"

• 或者直接用xcodebuild指定Playground的target：

xcodebuild -workspace PwP.xcworkspace -target "你的Playground Target名称" -configuration Debug build

要是不知道自己的Playground scheme/target叫啥，跑这个命令就能列出来所有可用的：

xcodebuild -list -workspace PwP.xcworkspace

如果只是想验证Playground有没有编译错误（不用生成产物），用analyze命令更高效，还能顺便做静态检查：

xcodebuild -workspace PwP.xcworkspace -target "你的Playground Target名称" analyze

2. 把步骤集成到CI流程 #

现在要把这些命令放进CI，确保框架代码一改，Playground就自动验证编译是否正常。下面以GitHub Actions为例，其他CI平台思路差不多：

示例GitHub Actions工作流 #

在项目根目录创建.github/workflows/playground-validation.yml，内容如下：

name: 验证Playground编译（框架变更触发）
on:
  push:
    paths:
      - 'PWPCore/**' # 只要框架目录有代码修改就触发
      - '你的Playground目录/**' # Playground自己改了也触发
  pull_request:
    paths:
      - 'PWPCore/**'
      - '你的Playground目录/**'

jobs:
  validate-playground:
    runs-on: macos-latest
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4

      - name: 指定Xcode版本（按需调整）
        run: sudo xcode-select -s /Applications/Xcode_15.0.app/Contents/Developer

      - name: 构建PWPCore框架
        run: xcodebuild -workspace PwP.xcworkspace -scheme PWPCore -configuration Debug build -quiet

      - name: 验证Playground编译
        run: xcodebuild -workspace PwP.xcworkspace -target "你的Playground Target名称" analyze -quiet

这个工作流会在框架或Playground代码变更时自动跑起来：先拉代码，配置Xcode，构建框架，最后验证Playground。要是Playground因为框架修改出了编译错误，CI就会失败，提醒开发者得更新Playground代码了。

其他CI平台适配（比如GitLab CI） #

思路完全一致，写个.gitlab-ci.yml片段就行：

validate_playground:
  stage: test
  tags:
    - macos # 确保runner是macOS环境
  script:
    - xcode-select -s /Applications/Xcode_15.0.app/Contents/Developer
    - xcodebuild -workspace PwP.xcworkspace -scheme PWPCore -configuration Debug build -quiet
    - xcodebuild -workspace PwP.xcworkspace -target "你的Playground Target名称" analyze -quiet
  only:
    changes:
      - PWPCore/**/*
      - 你的Playground目录/**/*

3. 常见坑点排查 #

• 找不到Playground的scheme/target：跑xcodebuild -list -workspace PwP.xcworkspace就能看到所有可用的，别输错名字～
• 编译时找不到框架：检查Playground的Build Settings里，Framework Search Paths有没有包含PWPCore的路径，或者工作区里有没有正确关联框架和Playground。
• CI环境编译失败：确认CI用的Xcode版本和本地一致，有些新语法或框架特性依赖特定Xcode版本。

这样就能实现你要的效果：CLI编译Playground，集成到CI，确保框架修改后Playground必须同步更新。

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