Bỏ qua tới nội dung
TakoAPI
Quay lại kỹ năng

instruments-profiling

bởi steipete

iOS & macOS Development
1.9kLượt tải do clawskills.sh công bố
3Sao
0Lượt xem
0 lượt thíchĐăng nhập để thích kỹ năng này
—Chưa có đánh giá
Đánh giá của bạn

Tóm tắt

Use when profiling native macOS or iOS apps.

Mô tả

Kỹ năng này làm gì

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.

Khi nào nên dùng

  • 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

Quy trình ví dụ

ĐẦU VÀO

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

AGENT
  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

ĐẦU RA

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

Yêu cầu

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

Cài đặt

clawhub install steipete/instruments-profiling

Chạy lệnh CLI, hoặc dán prompt vào Claude Code, Cursor, Codex hay coding agent bạn đang dùng.

Liên kết