# 使用 Homebrew 安装 xclogparser

查看 xclogparser 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:xclogparser
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install xclogparser
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:xclogparser
- **软件包管理器:** Homebrew
- **版本:** 0.2.49
- **来源摘要:** Tool to parse the SLF serialization format used by Xcode
- **主页:** <https://github.com/MobileNativeFoundation/XCLogParser>
- **仓库:** <https://github.com/MobileNativeFoundation/XCLogParser>
- **最后更新:** 2026-07-07T20:35:03Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- xclogparser (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 0.2.49
## 项目历史与用法

XCLogParser is a Swift command-line tool for parsing Xcode and `xcodebuild` logs stored as compressed `.xcactivitylog` files in Apple's SLF format. Its README presents it as a way to turn opaque build and test logs into JSON, HTML, Chrome trace, issue, and summary reports.

### 项目历史

The project came from Spotify's Apple-platform build tooling work and later moved under the Mobile Native Foundation organization. Its README points to Erick Camacho's AltConf 2019 talk about the `.xcactivitylog` format, and Spotify's later XCMetrics writing explains that XCLogParser was created to extract human-readable data from Xcode build logs.

XCLogParser's scope expanded from dumping raw logs to producing structured reports for build times, warnings, errors, unit-test results, Swift compiler timings, linker statistics, and Clang time-trace data. The GitHub releases page shows ongoing maintenance through v0.2.48 in June 2026, including parser updates for newer Xcode activity-log sections.

### 采用历史

The most visible downstream adoption is XCMetrics, Spotify's build-metrics system. Spotify and XCMetrics documentation state that XCMetrics is built on top of XCLogParser and has used it to collect large-scale build metrics across Spotify iOS applications, turning the parser from a standalone CLI into an engine for continuous developer-productivity measurement.

### 使用方式

Typical use is either `xclogparser dump` for raw JSON or `xclogparser parse` with a reporter such as `json`, `flatJson`, `summaryJson`, `chromeTracer`, `issues`, or `html`. The README documents locating logs by project, workspace, xcodeproj, explicit file, or DerivedData path.

The README also documents Xcode integration through a post-scheme build action, plus a caveat that since Xcode 11, command-line `xcodebuild` only generates `.xcactivitylog` build logs when `-resultBundlePath` is supplied. That detail is central to using the tool reliably in CI.

### 为什么软件包爱好者会关心

XCLogParser is significant because `.xcactivitylog` files are not pleasant text logs: they are gzipped binary SLF data in DerivedData. The tool gives package, CI, and build-performance nerds a stable way to mine Xcode's hidden build graph and timing data without depending on the Xcode UI.

### 时间线

- 2019: README points users to an AltConf 2019 talk about the Xcode activity-log format.
- 2020: Spotify introduces XCMetrics as a system built on top of XCLogParser for continuous build metrics.
- 2026-06-09: GitHub releases list v0.2.48 with parser updates for newer Xcode activity logs.

### Related projects

- XCMetrics is the major related project and uses XCLogParser as its log-parsing foundation.
- xcbeautify and similar xcodebuild log tools address console output readability, while XCLogParser focuses on `.xcactivitylog` and structured build telemetry.

### 来源

- <https://engineering.atspotify.com/introducing-xcmetrics-our-all-in-one-tool-for-tracking-xcode-build-metrics>
- <https://github.com/MobileNativeFoundation/XCLogParser#readme>
- <https://github.com/MobileNativeFoundation/XCLogParser/blob/master/docs/Xcactivitylog%20Format.md>
- <https://github.com/MobileNativeFoundation/XCLogParser/releases>
- <https://xcmetrics.io/docs/>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals


## Combined YAML source

View the package source record on GitHub. [combined/xclogparser.yml](https://github.com/mxcl/pkgdb/blob/main/combined/xclogparser.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph
