MobileNativeFoundation/XCLogParser

这是什么？

核心功能

• 01解析 Xcode 和 xcodebuild 生成的构建与测试 xcactivitylog 日志。
• 02支持 JSON、flat JSON、摘要 JSON、Chrome Tracer、issues 和 HTML 多种报告格式。
• 03统计各模块和文件的构建耗时，并列出警告与错误。
• 04可按项目、workspace 或 xcodeproj 名称自动查找最新日志。
• 05可作为 Xcode Post-action 脚本，在每次构建后自动生成报告。
• 06支持对输出中的用户名进行脱敏处理。

适用场景

• 定位 iOS 或 macOS 项目中拖慢构建的模块和文件。
• 在 CI 或看板中收集单元测试结果与构建警告。
• 将构建指标导入数据库，用于历史趋势分析。
• 在每次构建后通过 Chrome tracing 或 HTML 报告查看构建时间线。

快速上手

1. 1

   使用 Homebrew 安装 XCLogParser

   brew install xclogparser
2. 2

   将项目最新的构建日志解析为 HTML 报告（将 MyApp 替换为你的项目名）

   xclogparser parse --project MyApp --reporter html

使用前须知

• !README 中唯一记录的安装方式是 Homebrew，文档称更多安装方式仍在开发中。

收录于专题

标签

常见问题

XCLogParser 是什么？

一个 Swift 命令行工具，将 Xcode 的 xcactivitylog 构建与测试日志解析为 JSON、HTML 等报告。 XCLogParser 用于解析 Xcode 和 xcodebuild 写入 DerivedData 目录的 xcactivitylog 日志。这些日志采用 SLF 二进制格式，本工具可将其转换为可读数据。

XCLogParser 可以免费使用吗？用的什么许可证？

XCLogParser 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

XCLogParser 还在维护吗？

活跃维护中。XCLogParser 最近一次提交是在 2026年10月27日。

XCLogParser 适合用来做什么？

定位 iOS 或 macOS 项目中拖慢构建的模块和文件。 在 CI 或看板中收集单元测试结果与构建警告。 将构建指标导入数据库，用于历史趋势分析。 在每次构建后通过 Chrome tracing 或 HTML 报告查看构建时间线。

XCLogParser 怎么安装和运行？

使用 Homebrew 安装 XCLogParser: brew install xclogparser 将项目最新的构建日志解析为 HTML 报告（将 MyApp 替换为你的项目名）: xclogparser parse --project MyApp --reporter html

在哪里获取 XCLogParser？

源代码和安装说明在 GitHub 上：https://github.com/MobileNativeFoundation/XCLogParser