Repolode
cpisciotta

cpisciotta/xcbeautify

用 Swift 编写的 xcodebuild 输出美化工具,让冗长的构建日志变得清晰易读,可作为 xcpretty 的更快替代。

可替代:xcpretty

Star
1,555
Fork
110
未关闭 Issue
66
最近提交
3个月前

这是什么?

xcbeautify 是一个命令行工具,用于重新格式化 xcodebuild 的原始输出。xcodebuild 是 Xcode 项目的构建和测试驱动程序,其默认日志冗长难读。使用时只需将 xcodebuild 的输出通过管道交给 xcbeautify,即可得到带颜色、便于阅读的结果,错误、警告和测试结果都会被突出显示。

该工具使用 Swift 编写并编译为静态二进制文件,无需依赖 Ruby 环境。项目定位为 xcpretty 的更快替代品,支持 macOS 和 Linux。它同时兼容新构建系统的输出、Xcode 的并行测试输出,以及 swift test 的 Swift Package Manager 输出。

在持续集成场景中,xcbeautify 可以生成 JUnit 报告,并内置 GitHub Actions、TeamCity 和 Azure DevOps Pipelines 渲染器,将警告和错误直接显示在这些平台的界面中。

核心功能

  • 01将 xcodebuild 日志转换为带颜色、易于阅读的输出。
  • 02支持新构建系统、Xcode 并行测试以及 Swift Package Manager 的输出。
  • 03可生成 JUnit 报告。
  • 04内置 GitHub Actions、TeamCity 和 Azure DevOps Pipelines 渲染器。
  • 05以静态二进制形式分发,支持 macOS 和 Linux。

适用场景

  • 让本地开发时的 Xcode 构建和测试日志更易读。
  • 在 GitHub Actions 中直接查看 iOS 构建警告和测试失败信息。
  • 在 CI 流水线中从 xcodebuild 运行结果生成 JUnit 测试报告。

快速上手

  1. 1

    通过 Homebrew 安装

    brew install xcbeautify
  2. 2

    将 xcodebuild 输出通过管道传给 xcbeautify

    xcodebuild [flags] | xcbeautify

使用前须知

  • 它针对 Xcode 和 Swift 的构建输出,因此只适用于 Apple 平台或 Swift 构建流程。

收录于专题

标签

常见问题

xcbeautify 是什么?
用 Swift 编写的 xcodebuild 输出美化工具,让冗长的构建日志变得清晰易读,可作为 xcpretty 的更快替代。 xcbeautify 是一个命令行工具,用于重新格式化 xcodebuild 的原始输出。xcodebuild 是 Xcode 项目的构建和测试驱动程序,其默认日志冗长难读。使用时只需将 xcodebuild 的输出通过管道交给 xcbeautify,即可得到带颜色、便于阅读的结果,错误、警告和测试结果都会被突出显示。
xcbeautify 可以免费使用吗?用的什么许可证?
xcbeautify 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
xcbeautify 还在维护吗?
半年内有更新。xcbeautify 最近一次提交是在 2026年8月10日。
xcbeautify 适合用来做什么?
让本地开发时的 Xcode 构建和测试日志更易读。 在 GitHub Actions 中直接查看 iOS 构建警告和测试失败信息。 在 CI 流水线中从 xcodebuild 运行结果生成 JUnit 测试报告。
xcbeautify 怎么安装和运行?
通过 Homebrew 安装: brew install xcbeautify 将 xcodebuild 输出通过管道传给 xcbeautify: xcodebuild [flags] | xcbeautify
在哪里获取 xcbeautify?
源代码和安装说明在 GitHub 上:https://github.com/cpisciotta/xcbeautify

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目