XCLogParser 解析Xcode 15.3构建日志失败问题分析

问题背景

XCLogParser是一个用于解析Xcode构建日志的工具，它能够将Xcode的xcactivitylog文件转换为更易读的格式（如HTML或JSON）。然而，随着Xcode 15.3的发布，用户报告XCLogParser无法正确解析新版本的构建日志，导致生成大量小文件或解析失败。

问题现象

当使用Xcode 15.3构建项目并尝试用XCLogParser解析日志时，会出现以下错误：

"com.apple.dt.ActivityLogSectionAttachment.TaskMetrics"], [type: int, value: 1], [type: int, value: 0]]
Error: The line *{"wcStartTime":73149 doesn't seem like a valid SLF line

解析过程会产生大量小文件（报告称产生了19741个文件，总计1.3GB），而不是预期的单一报告文件。

根本原因

经过分析，这个问题源于Xcode 15.3引入了新的日志格式版本（logFormatVersion 11），其中包含了一个新的IDEActivityLogSectionAttachment类型。这个附件包含了一个JSON格式的BuildOperationTaskMetrics对象，其格式以星号(*)开头，这与XCLogParser现有的解析逻辑不兼容。

BuildOperationTaskMetrics对象包含了构建任务的各种度量指标，如任务开始时间、结束时间等性能数据。这些数据原本是Xcode构建系统内部使用的，但在Xcode 15.3中被直接包含在了活动日志中。

技术细节

新的日志格式中，BuildOperationTaskMetrics对象以特殊标记(*)开头，后面跟随JSON数据。例如：

*{"wcStartTime":73149, ...}

这种格式打破了XCLogParser原有的行解析逻辑，导致解析器无法正确识别日志行。解析器期望每行都是标准的SLF(Super Log Format)格式，而新引入的这种混合格式造成了兼容性问题。

解决方案

社区已经提出了修复方案，主要修改包括：

1. 更新日志行解析逻辑，识别并正确处理以星号(*)开头的JSON数据
2. 扩展BuildStep模型，增加对BuildOperationTaskMetrics的支持
3. 确保新格式的日志能够被正确解析而不影响其他日志信息的处理

修复方案需要仔细处理这些新的度量数据，同时保持向后兼容性，确保工具仍然能够处理旧版本的Xcode日志。

影响范围

这个问题影响所有使用Xcode 15.3及以上版本并依赖XCLogParser进行构建日志分析的用户。特别是那些使用XCLogParser进行持续集成构建分析或构建性能优化的团队。

临时解决方案

在官方修复发布前，用户可以：

1. 暂时降级到Xcode 15.2或更早版本
2. 手动处理生成的报告文件，提取有用信息
3. 使用其他日志分析工具临时替代

未来展望

随着Xcode构建系统的持续演进，类似的格式变更可能会再次发生。XCLogParser项目需要考虑：

1. 建立更灵活的日志格式解析机制
2. 增加对Xcode新版本的兼容性测试
3. 提供更清晰的版本兼容性说明

这个问题凸显了开发工具链中依赖关系管理的重要性，特别是在持续集成环境中，工具链的各个组件需要保持版本同步和兼容性。