如何在命令行指定XCode TestPlan要使用的测试配置？

可以通过xcodebuild的专属参数指定TestPlan中需要包含或排除的测试配置，该功能仅支持Xcode 13及更高版本。

核心参数说明 #

• -testPlan <测试计划名称>：先指定你要操作的TestPlan，是后续配置筛选生效的前提
• -only-test-configuration <配置名称>：指定仅运行该测试配置，需要添加多个配置时可重复传入该参数
• -skip-test-configuration <配置名称>：指定排除该测试配置，其余配置全部运行，需要排除多个配置时可重复传入该参数

常用示例 #

仅运行指定配置 #

比如你的Scheme叫MyAppUITest，TestPlan叫FullTestPlan，要仅运行「iOS17_正式环境」和「iOS16_测试环境」两个配置，命令如下：

xcodebuild test \
-scheme MyAppUITest \
-testPlan FullTestPlan \
-only-test-configuration "iOS17_正式环境" \
-only-test-configuration "iOS16_测试环境" \
-destination 'platform=iOS Simulator,name=iPhone 14,OS=17.0'

仅排除指定配置 #

排除「深色模式适配测试」配置，其余全部运行：

xcodebuild test \
-scheme MyAppUITest \
-testPlan FullTestPlan \
-skip-test-configuration "深色模式适配测试" \
-destination 'platform=iOS Simulator,name=iPhone 14,OS=17.0'

注意事项 #

• 如果测试配置名称包含空格、中文或特殊字符，必须用英文双引号包裹，避免命令解析错误
• 若同时传入-only-test-configuration和-skip-test-configuration，只会执行在包含列表中、且不在排除列表中的配置
• CI场景中可结合环境变量动态传入要包含/排除的配置名，无需修改固定命令脚本

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