Repolode
Enviar
MobileNativeFoundation

MobileNativeFoundation/XCLogParser

Uma CLI em Swift que converte logs de build e testes do xcactivitylog do Xcode em JSON, HTML, Chrome tracing e relatórios de issues.

Ver no GitHub
Estrelas
1,852
Forks
140
Issues abertas
43
Último commit
há 10 dias

O que é?

O XCLogParser lê os logs binários no formato SLF que o Xcode e o xcodebuild gravam em DerivedData (arquivos xcactivitylog) e os transforma em dados legíveis. Ele pode exportar um log bruto como JSON ou gerar relatórios com tempos de build por módulo e arquivo, warnings, erros e resultados de testes unitários.

A ferramenta oferece vários formatos de relatório: JSON completo, JSON plano para carregar em um banco de dados, JSON resumido, um arquivo de Chrome tracing para visualizar em chrome://tracing, uma lista de issues e uma página HTML estática. Também pode exportar o LogStoreManifest.plist para listar os logs gerados para um projeto.

É possível localizar o log mais recente pelo nome de um projeto, workspace ou xcodeproj, além de executar a ferramenta como uma ação post-scheme do Xcode para gerar o relatório após cada build. Entradas opcionais, como tempos de type-check do swiftc, estatísticas do linker ld64 e dados de clang -ftime-trace, são incorporadas à saída quando essas flags estão habilitadas. A instalação está disponível pelo Homebrew, e o projeto pode ser compilado no macOS e no Linux via Docker.

Recursos principais

  • 01Analisa logs de build e testes xcactivitylog gerados pelo Xcode e pelo xcodebuild.
  • 02Gera relatórios em JSON, JSON plano, JSON resumido, Chrome tracing, lista de issues ou HTML.
  • 03Apresenta o tempo de build por módulo e arquivo, além de warnings e erros.
  • 04Localiza o log mais recente pelo nome do projeto, workspace ou xcodeproj.
  • 05Pode ser executado como uma ação post-scheme do Xcode para gerar relatórios após cada build.
  • 06Oferece suporte opcional à ocultação de nomes de usuário nos caminhos de arquivos.

Casos de uso

  • Descobrir quais módulos ou arquivos deixam mais lento o build de um projeto para iOS ou macOS.
  • Coletar resultados de testes unitários e warnings de build em CI ou dashboards.
  • Enviar métricas de build a um banco de dados para analisar tendências ao longo do tempo.
  • Visualizar cronogramas de build no Chrome tracing ou em um relatório HTML após cada build.

Início rápido

  1. 1

    Instale o XCLogParser com o Homebrew

    brew install xclogparser
  2. 2

    Converta o log de build mais recente do seu projeto em um relatório HTML (substitua MyApp pelo nome do seu projeto)

    xclogparser parse --project MyApp --reporter html

Antes de usar

  • O Homebrew é a única opção de instalação documentada; o README informa que outras opções ainda estão sendo adicionadas.

Em coleções

Apps open source para MacPlataformas de OpenTelemetry e observabilidade

Tópicos

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

Perguntas frequentes

O que é XCLogParser?
Uma CLI em Swift que converte logs de build e testes do xcactivitylog do Xcode em JSON, HTML, Chrome tracing e relatórios de issues. O XCLogParser lê os logs binários no formato SLF que o Xcode e o xcodebuild gravam em DerivedData (arquivos xcactivitylog) e os transforma em dados legíveis. Ele pode exportar um log bruto como JSON ou gerar relatórios com tempos de build por módulo e arquivo, warnings, erros e resultados de testes unitários.
XCLogParser é gratuito? Qual é a licença?
XCLogParser é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
XCLogParser ainda é mantido?
Manutenção ativa. O último commit de XCLogParser foi em 27 de out. de 2026.
Para que posso usar XCLogParser?
Descobrir quais módulos ou arquivos deixam mais lento o build de um projeto para iOS ou macOS. Coletar resultados de testes unitários e warnings de build em CI ou dashboards. Enviar métricas de build a um banco de dados para analisar tendências ao longo do tempo. Visualizar cronogramas de build no Chrome tracing ou em um relatório HTML após cada build.
Como instalar XCLogParser?
Instale o XCLogParser com o Homebrew: brew install xclogparser Converta o log de build mais recente do seu projeto em um relatório HTML (substitua MyApp pelo nome do seu projeto): xclogparser parse --project MyApp --reporter html
Onde consigo XCLogParser?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/MobileNativeFoundation/XCLogParser

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados