Repolode
Предложить
MobileNativeFoundation

MobileNativeFoundation/XCLogParser

CLI на Swift, который преобразует логи сборки и тестов Xcode в формате xcactivitylog в JSON, HTML, трассировки Chrome и отчёты об ошибках.

Открыть на GitHub
Звёзды
1,852
Форки
140
Открытые issues
43
Последний коммит
11 дней назад

Что это?

XCLogParser читает бинарные логи в формате SLF, которые Xcode и xcodebuild записывают в DerivedData (файлы xcactivitylog), и преобразует их в удобные для чтения данные. Он может выгружать исходный лог в JSON или создавать отчёты со временем сборки по модулям и файлам, предупреждениями, ошибками и результатами модульных тестов.

Инструмент предлагает несколько форматов отчётов: полный JSON, плоский JSON для загрузки в базу данных, сводный JSON, файл трассировки Chrome для просмотра в chrome://tracing, список проблем и статическую HTML-страницу. Также он может выгружать LogStoreManifest.plist со списком логов, созданных для проекта.

Инструмент может находить последний лог по имени проекта, workspace или xcodeproj, а также запускаться как действие post-scheme в Xcode, чтобы создавать отчёт после каждой сборки. При включённых соответствующих флагах в результат добавляются дополнительные данные, например время проверки типов swiftc, статистика линковщика ld64 и данные clang -ftime-trace. Установить инструмент можно через Homebrew; проект собирается на macOS и Linux с помощью Docker.

Ключевые возможности

  • 01Разбирает логи сборки и тестов xcactivitylog, созданные Xcode и xcodebuild.
  • 02Создаёт отчёты в форматах JSON, плоский JSON, сводный JSON, трассировка Chrome, список проблем или HTML.
  • 03Показывает время сборки по модулям и файлам, а также предупреждения и ошибки.
  • 04Находит последний лог по имени проекта, workspace или xcodeproj.
  • 05Может запускаться как действие post-scheme в Xcode и создавать отчёты после каждой сборки.
  • 06Поддерживает необязательное сокрытие имён пользователей в путях к файлам.

Сценарии использования

  • Поиск модулей или файлов, которые замедляют сборку проекта для iOS или macOS.
  • Сбор результатов модульных тестов и предупреждений сборки в CI или для дашбордов.
  • Загрузка метрик сборки в базу данных для анализа изменений во времени.
  • Просмотр временной шкалы сборки в Chrome tracing или HTML-отчёте после каждой сборки.

Быстрый старт

  1. 1

    Установите XCLogParser с помощью Homebrew

    brew install xclogparser
  2. 2

    Преобразуйте последний лог сборки проекта в HTML-отчёт (замените MyApp на название проекта)

    xclogparser parse --project MyApp --reporter html

Что важно знать

  • В документации описан только способ установки через Homebrew; в README сказано, что другие варианты ещё добавляются.

В подборках

Open source приложения для MacOpenTelemetry и платформы наблюдаемости

Темы

#xcode#ios#build-performance#swift#logging#ci#macos#developer-tools#swift-package-manager#xcactivitylog

Частые вопросы

Что такое XCLogParser?
CLI на Swift, который преобразует логи сборки и тестов Xcode в формате xcactivitylog в JSON, HTML, трассировки Chrome и отчёты об ошибках. XCLogParser читает бинарные логи в формате SLF, которые Xcode и xcodebuild записывают в DerivedData (файлы xcactivitylog), и преобразует их в удобные для чтения данные. Он может выгружать исходный лог в JSON или создавать отчёты со временем сборки по модулям и файлам, предупреждениями, ошибками и результатами модульных тестов.
XCLogParser можно использовать бесплатно? Какая у него лицензия?
XCLogParser распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
XCLogParser всё ещё поддерживается?
Активно поддерживается. Последний коммит в XCLogParser — 27 окт. 2026 г..
Для чего можно использовать XCLogParser?
Поиск модулей или файлов, которые замедляют сборку проекта для iOS или macOS. Сбор результатов модульных тестов и предупреждений сборки в CI или для дашбордов. Загрузка метрик сборки в базу данных для анализа изменений во времени. Просмотр временной шкалы сборки в Chrome tracing или HTML-отчёте после каждой сборки.
Как установить XCLogParser?
Установите XCLogParser с помощью Homebrew: brew install xclogparser Преобразуйте последний лог сборки проекта в HTML-отчёт (замените MyApp на название проекта): xclogparser parse --project MyApp --reporter html
Где скачать XCLogParser?
Исходный код и инструкции по установке — на GitHub: https://github.com/MobileNativeFoundation/XCLogParser

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты