Periphery项目多目标扫描参数格式变更解析

问题背景

在Xcode项目静态分析工具Periphery的使用过程中，开发者发现从2.18.0版本开始，当尝试同时扫描多个Xcode目标(target)时会出现"目标不存在"的错误提示。具体表现为：使用逗号分隔多个目标的传统方式突然失效，而单独扫描一个目标则工作正常。

参数格式变更详情

Periphery 2.18.0版本对命令行参数解析进行了重大调整，从原先自定义的参数解析方式迁移到了Swift官方的swift-argument-parser框架。这一变更带来了更标准的命令行参数处理方式，但也导致了多目标参数格式的变化：

旧格式（2.18.0之前）：

--targets "Target1,Target2,Target3"

新格式（2.18.0及之后）：

--targets Target1 Target2 Target3

技术原理

swift-argument-parser框架采用了Unix/Linux命令行工具的标准参数解析方式，其中：

• 每个空格分隔的参数都被视为独立的值
• 不再需要将多个值用逗号连接成一个字符串
• 引号仅用于包含含有空格的特殊参数值

这种变更使Periphery的命令行接口更加符合开发者对其他命令行工具的预期使用方式。

影响范围

这一变更主要影响以下场景：

1. 同时扫描多个Xcode目标的场景
2. 自动化脚本中调用Periphery的代码
3. CI/CD流水线中的Periphery调用

解决方案

开发者需要将现有的多目标参数从逗号分隔格式调整为空格分隔格式。例如：

修改前：

periphery scan --targets "App1,App1Widget,App2" --schemes Periphery

修改后：

periphery scan --targets App1 App1Widget App2 --schemes Periphery

最佳实践建议

1. 在升级Periphery版本时，务必查阅CHANGELOG了解破坏性变更
2. 在CI/CD脚本中使用版本约束，避免意外升级导致构建失败
3. 考虑将Periphery配置迁移到.periphery.yml文件中，减少命令行参数的使用
4. 对于复杂的扫描需求，建议先在小规模项目上测试新版本

总结

Periphery项目向标准参数解析方式的演进虽然带来了短期的适配成本，但从长远看提高了工具的一致性和可维护性。开发者应及时调整使用习惯，采用新的参数格式以获得更好的工具使用体验。