본문으로 건너뛰기
TakoAPI
스킬로 돌아가기

instruments-profiling

steipete 제작

iOS & macOS Development
1.9kclawskills.sh가 보고한 다운로드 수
3스타
0조회수
좋아요 0개로그인하면 이 스킬에 좋아요를 누를 수 있습니다
—아직 평가 없음
내 평가

요약

Use when profiling native macOS or iOS apps.

설명

이 스킬이 하는 일

Covers performance profiling for native macOS and iOS apps using xctrace CLI and the Instruments UI. Addresses correct binary selection, CLI arguments, stack exports, and common gotchas like LaunchServices resolving the wrong app bundle.

Instruments and xctrace have non-obvious argument ordering and bundle-resolution gotchas that cause silent profiling errors; this skill documents the fixes directly.

사용 시점

  • Profiling slow app startup on macOS
  • Capturing CPU samples from a running iOS app by PID
  • Exporting time-profile stacks to XML for offline analysis
  • Identifying hot frames in a native app's call tree
  • Attaching a profiler to a live process without restarting it

예시 워크플로

입력

User asks: how do I profile my macOS app's startup with xctrace?

에이전트
  1. 1

    Run xcrun xctrace list templates to confirm Time Profiler is available

  2. 2

    Locate the direct binary path to avoid LaunchServices resolving an installed bundle instead of the local build

  3. 3

    Run xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --launch -- /path/App.app/Contents/MacOS/App

  4. 4

    Verify the traced process path matches the intended build using ps -p <pid> -o comm= -o command=

  5. 5

    Open the trace with open -a Instruments /tmp/App.trace and review the call tree with Invert Call Tree and Hide System Libraries

출력

A .trace file opened in Instruments showing CPU samples and hot frames covering the app's startup path

요구 사항

  • Xcode installed (provides xctrace CLI and Instruments)
  • Developer Tools permission granted in System Settings → Privacy & Security → Developer Tools

설치

clawhub install steipete/instruments-profiling

CLI 명령을 실행하거나, 프롬프트를 Claude Code, Cursor, Codex 등 사용하는 코딩 에이전트에 붙여넣으세요.

링크