CI环境下构建iOS真机XCUITest测试包报错的解决方案咨询

问题说明 #

在搭建iOS CI/CD流程时，尝试构建XCUITest测试包并上传至pCloudy执行真机测试，使用fastlane的run_tests指定destination: 'generic/platform=iOS'时触发报错：

Unable to find a destination matching the provided destination specifier:
{ generic:1, platform:iOS }

核心原因是xcodebuild单独使用generic/platform=iOS作为目标时，无法识别通用真机平台，必须配合指定iOS SDK参数才能生成可跨真机运行的测试包。

可行解决方案 #

方案1：直接用sh执行带SDK参数的xcodebuild命令 #

替换原run_tests动作，使用以下脚本直接调用xcodebuild，明确指定真机SDK：

sh("set -o pipefail && env NSUnbufferedIO=YES xcodebuild -workspace ./app.xcworkspace -scheme appUITests -configuration Dev -derivedDataPath derived_data -sdk iphoneos -destination 'generic/platform=iOS' clean build-for-testing")

关键新增参数-sdk iphoneos，用于告诉xcodebuild针对iOS真机SDK构建通用测试包。

方案2：使用fastlane的build_ios_app动作封装构建逻辑 #

如果偏好fastlane封装好的动作，可改用build_ios_app并配置测试相关参数：

build_ios_app(
  workspace: "./app.xcworkspace",
  scheme: "appUITests",
  configuration: "Dev",
  derived_data_path: "derived_data",
  sdk: "iphoneos",
  destination: "generic/platform=iOS",
  build_for_testing: true,
  clean: true
)

构建产物验证 #

构建完成后，在derived_data/Build/Products/Dev-iphoneos目录下会生成两个核心文件：

• appUITests-Runner.app：测试运行器
• appUITests.xctestrun：测试配置清单

将这两个文件上传至pCloudy即可在远程真机上执行XCUITest。

内容的提问来源于stack exchange，提问作者linh lê