MobileNativeFoundation/XCLogParser

これは何？

主な機能

• 01Xcodeとxcodebuildが生成するxcactivitylog形式のビルド・テストログを解析します。
• 02JSON、フラットなJSON、サマリーJSON、Chrome tracing、issue一覧、HTMLでレポートを出力します。
• 03モジュールやファイルごとのビルド時間に加え、警告とエラーをレポートします。
• 04プロジェクト名、workspace名、xcodeproj名から最新のログを検索します。
• 05Xcodeのpost-scheme 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

使う前に知っておきたいこと

• !ドキュメントに記載されているインストール方法はHomebrewのみです。READMEには、ほかの方法も追加予定と記載されています。

収録されている特集

トピック

よくある質問

XCLogParser とは？

Xcodeのxcactivitylog形式のビルド・テストログを解析し、JSON、HTML、Chrome tracing、issueレポートに出力するSwift製CLIです。 XCLogParserは、XcodeやxcodebuildがDerivedDataに書き出すバイナリのSLF形式ログ（xcactivitylogファイル）を読み込み、確認しやすいデータに変換します。生ログをJSONとして出力できるほか、モジュールやファイルごとのビルド時間、警告、エラー、ユニットテスト結果を含むレポートを生成できます。

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