如何通过命令行构建iOS「App Playground」？

我太懂这种卡壳的感觉了——用Xcode GUI点几下就能正常构建的App Playground，一到命令行就报error: no such module 'AppleProductTypes'，尤其是要搭CI自动化的时候，这个错误简直是拦路虎。

其实问题根源很明确：App Playground是苹果为Playgrounds App量身定做的特殊模板，它依赖了Xcode内部的私有模块（比如AppleProductTypes），如果命令行工具链没和Xcode完全对齐，就找不到这些专属模块。下面是我亲测有效的解决步骤：

• 先对齐Xcode命令行工具链
  首先要确保你用的是Xcode自带的命令行工具，而不是单独安装的Swift工具链。先运行这个命令检查当前工具链路径：
  xcode-select -p
  如果输出不是/Applications/Xcode.app/Contents/Developer，就用下面的命令强制切换：
  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

• 用xcodebuild指定完整项目参数
  别直接用swift package resolve或者裸的xcodebuild，App Playground不是标准Swift Package，必须通过Xcode的工作区和scheme来构建。给你个实际可用的命令模板：
  xcodebuild -workspace "YourPlayground.xcworkspace" -scheme "Your App Playground Scheme" -destination 'platform=iOS Simulator,name=iPhone 15' build
  记得把里面的工作区名称、scheme名称和模拟器型号替换成你自己的。要是不确定项目里的scheme有哪些，用xcodebuild -list就能列出所有可选scheme。

• CI环境额外要做的准备
  如果是在CI机器上跑构建，还要提前搞定这几件事：

  • 运行sudo xcodebuild -license accept接受Xcode许可协议，避免构建时卡在交互步骤
  • 确保CI机器上安装了对应iOS版本的模拟器运行时，不然会报找不到运行目标的错误
  • 确认Xcode版本在14.0及以上，App Playground是从这个版本开始正式支持的

最后给个排查小技巧：先在本地命令行把构建命令跑通，再移植到CI环境，这样能快速区分是项目配置问题还是CI环境的问题。

内容来源于stack exchange