xcdiff 是一个可扩展的工具，用于查找两个 .xcodeproj 项目文件之间的差异。它可以被认为是 .xcodeproj 文件的 git diff 工具，可以直接从命令行使用，也可以作为库来支持您自己的工具集。

在您的项目目录中运行命令 xcdiff 将在该目录中搜索两个 .xcodeproj 文件，并对项目使用 xcdiff 的所有比较器（例如，targets、sources 和 headers）。

您还可以指定两个特定的项目供 xcdiff 比较。

xcdiff -p1 OriginalProject.xcodeproj -p2 GeneratedProject.xcodeproj

以下是一个示例输出

要查看差异的详细报告，您可以指定 --verbose (-v) 选项。

xcdiff -p1 OriginalProject.xcodeproj -p2 GeneratedProject.xcodeproj -v

• 当采用项目生成（例如，使用像 XcodeGen 或 Tuist 这样的工具）时，将生成的 xcodeproj 文件与原始文件进行比较可以帮助您增强迁移过程的信心。
• 可能还有一些我们尚未想到的用例！...

• 安装 xcdiff 并从命令行使用。
• 添加为 您的 macOS 项目的依赖项（xcdiff 遵循 语义版本控制）。

• 阅读 xcdiff CLI 文档或尝试 xcdiff --help。
• 查看如何在您自己的项目中使用 XCDiffCore Framework。

欢迎对 xcdiff 的所有改进！

如果您发现您想要修复的问题，最好的方法是通过提交实现该问题的 Pull Request 来提供帮助。 在发送 Pull Request 之前，请确保您阅读了我们的 贡献指南。 开发文档 中的信息可以帮助您设置本地开发环境。

我们也欢迎 问题报告。 确保为您的问题选择适当的问题模板，以便提供所有必要的详细信息。

我们要感谢以下项目的作者和贡献者

• XcodeProj
• SwiftPM（实用程序库）

本项目采用了 行为准则。 如果您对行为准则有任何疑虑，或者您在项目中遇到的行为，请通过 opensource@bloomberg.net 与我们联系。

如果您认为您在此项目中发现了安全漏洞，请发送电子邮件至项目团队 opensource@bloomberg.net，详细说明您怀疑的问题以及您发现的任何重现方法。

请不要在 GitHub 存储库中打开问题，因为我们希望在有机会审查和解决这些问题之前，将漏洞报告保持私密状态。

xcdiff 在 Apache 许可证 2.0 版本下发布。