MobileNativeFoundation/XCLogParser
Xcode의 xcactivitylog 빌드 및 테스트 로그를 JSON, HTML, Chrome tracing, 이슈 리포트로 변환하는 Swift CLI입니다.
- 스타
- 1,852
- 포크
- 140
- 열린 이슈
- 43
- 마지막 커밋
- 10일 전
어떤 프로젝트인가요?
XCLogParser는 Xcode와 xcodebuild가 DerivedData에 기록하는 바이너리 SLF 형식 로그(xcactivitylog 파일)를 읽어 보기 쉬운 데이터로 변환합니다. 원시 로그를 JSON으로 출력하거나, 모듈 및 파일별 빌드 시간과 경고, 오류, 단위 테스트 결과를 담은 리포트를 생성할 수 있습니다.
여러 리포터를 제공합니다. 전체 JSON, 데이터베이스에 불러오기 위한 flat JSON, 요약 JSON, chrome://tracing에서 볼 수 있는 Chrome tracing 파일, 이슈 목록, 정적 HTML 페이지를 생성합니다. LogStoreManifest.plist를 덤프해 프로젝트에서 생성된 로그 목록을 확인할 수도 있습니다.
프로젝트, workspace 또는 xcodeproj 이름으로 최신 로그를 찾을 수 있으며, Xcode post-scheme action으로 실행해 각 빌드가 끝난 뒤 리포트를 생성할 수도 있습니다. swiftc 타입 검사 시간, ld64 링커 통계, clang -ftime-trace 데이터와 같은 선택적 입력은 해당 플래그를 활성화하면 출력에 병합됩니다. Homebrew로 설치할 수 있으며, Docker를 통해 macOS와 Linux에서 빌드할 수 있습니다.
핵심 기능
- 01Xcode와 xcodebuild가 생성하는 xcactivitylog 빌드 및 테스트 로그를 파싱합니다.
- 02JSON, flat JSON, 요약 JSON, Chrome tracing, 이슈 목록 또는 HTML 형식으로 리포트를 출력합니다.
- 03모듈 및 파일별 빌드 시간과 경고, 오류를 리포트합니다.
- 04프로젝트, workspace 또는 xcodeproj 이름으로 최신 로그를 찾습니다.
- 05Xcode post-scheme action으로 실행해 각 빌드가 끝난 뒤 리포트를 생성할 수 있습니다.
- 06파일 경로에 포함된 사용자 이름을 선택적으로 마스킹할 수 있습니다.
활용 사례
- iOS 또는 macOS 프로젝트의 빌드를 느리게 하는 모듈이나 파일을 찾습니다.
- CI나 대시보드에서 단위 테스트 결과와 빌드 경고를 수집합니다.
- 과거 추세를 분석하기 위해 빌드 메트릭을 데이터베이스에 저장합니다.
- 각 빌드가 끝난 뒤 Chrome tracing이나 HTML 리포트에서 빌드 타임라인을 확인합니다.
빠른 시작
- 1
Homebrew로 XCLogParser를 설치합니다
brew install xclogparser - 2
프로젝트의 최신 빌드 로그를 HTML 보고서로 변환합니다(MyApp을 프로젝트 이름으로 바꾸세요)
xclogparser parse --project MyApp --reporter html
사용 전 알아둘 점
- 문서에 안내된 설치 방법은 Homebrew뿐입니다. README에는 다른 방법도 추가할 예정이라고 나와 있습니다.
포함된 컬렉션
토픽
자주 묻는 질문
- XCLogParser은(는) 무엇인가요?
- Xcode의 xcactivitylog 빌드 및 테스트 로그를 JSON, HTML, Chrome tracing, 이슈 리포트로 변환하는 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
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
하나의 Mac에서 더 많은 시뮬레이터를 메모리에 띄울 수 있도록 iOS, tvOS, watchOS, visionOS 시뮬레이터의 백그라운드 데몬을 끄는 macOS CLI 및 앱입니다.
Apple의 simctl 도구를 감싼 GUI로 iOS, tvOS, watchOS 시뮬레이터를 제어하는 macOS 앱입니다.
Linux, Windows, macOS에서 SwiftPM 패키지로 iOS 앱을 빌드·서명·설치하는 크로스 플랫폼 Xcode 대체 도구입니다.
Swift 코드를 일관된 스타일로 자동 정리하는 CLI 도구이자 Xcode 확장 프로그램입니다.