解决Periphery工具在Xcode构建脚本中的权限问题

Periphery是一款优秀的Swift代码静态分析工具，能够帮助开发者检测项目中未使用的代码。然而在实际使用过程中，很多开发者会遇到在Xcode构建脚本中运行Periphery时出现权限问题的困扰。

常见问题表现

当开发者通过Homebrew安装Periphery后，在终端直接运行periphery --scan命令时一切正常，但在Xcode的构建脚本中执行periphery scan --format xcode时，通常会遇到以下两种错误：

1. 简单的"Command PhaseScriptExecution failed with a nonzero exit code"错误
2. 更详细的权限错误，提示无法读取.periphery.yml配置文件

问题根源分析

这些问题的根本原因在于Xcode的沙盒安全机制。Xcode在运行构建脚本时会启用沙盒环境，严格限制脚本对文件系统的访问权限，特别是对用户主目录下的文件访问。

当Periphery尝试读取用户主目录下的配置文件(~/.periphery.yml)时，由于沙盒限制而无法访问，导致扫描失败。

解决方案

解决这个问题的关键在于让Periphery能够在Xcode的沙盒环境中正常运行。以下是具体解决方案：

1. 修改构建脚本：在Xcode的构建脚本中，首先需要明确指定Periphery的完整路径

2. 处理配置文件：将.periphery.yml配置文件从用户主目录移动到项目目录中，这样Xcode的沙盒环境就能正常访问

3. 调整Xcode设置：在Xcode的Scheme设置中，为构建脚本添加适当的权限

具体实施步骤

1. 将.periphery.yml配置文件从用户主目录(~/)复制到项目根目录

2. 修改Xcode构建脚本内容如下：

cd "${SRCROOT}"
/opt/homebrew/bin/periphery scan --format xcode --config .periphery.yml

3. 在Xcode中，选择Product > Scheme > Edit Scheme，找到Build阶段的Pre-actions，确保脚本有足够的执行权限

注意事项

1. 确保项目目录中的.periphery.yml文件具有正确的读写权限

2. 如果使用自定义配置文件路径，需要在scan命令中明确指定

3. 对于团队项目，建议将配置文件纳入版本控制，确保所有成员使用相同的配置

通过以上步骤，Periphery就能在Xcode的构建脚本中正常运行，帮助开发者持续监控项目中的无用代码，保持代码库的整洁。