ネイティブアプリパフォーマンス (CLIのみ)
目標: xctrace を介して Time Profiler を記録し、サンプルを抽出してシンボリケーションし、Instruments を開かずにホットスポットを特定します。
クイックスタート (CLI)
- Time Profiler の記録 (アタッチ):
# アプリを自分で起動し、その後アタッチ
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --attach <pid>
- Time Profiler の記録 (起動):
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --launch -- /path/App.app/Contents/MacOS/App
- 時間サンプルの抽出:
scripts/extract_time_samples.py --trace /tmp/App.trace --output /tmp/time-sample.xml
- シンボリケーション用のロードアドレスを取得:
# アプリ実行中に
vmmap <pid> | rg -m1 "__TEXT" -n
- シンボリケーション + ホットスポットのランキング:
scripts/top_hotspots.py --samples /tmp/time-sample.xml \
--binary /path/App.app/Contents/MacOS/App \
--load-address 0x100000000 --top 30
ワークフローノート
- 常に正しいバイナリをプロファイリングしていることを確認してください(ローカルビルドか
/Applicationsか)。--launchには直接バイナリパスを指定することを推奨します。 - キャプチャ中に低速パスをトリガーするようにしてください(メニューの開閉、リフレッシュなど)。
- スタックが空の場合は、より長くキャプチャするか、アイドル部分を避けてください。
xcrun xctrace help recordおよびxcrun xctrace help exportで正しいフラグを確認できます。
含まれるスクリプト
scripts/record_time_profiler.sh: アタッチまたは起動による記録を行います。scripts/extract_time_samples.py: トレースから time-sample XML をエクスポートします。scripts/top_hotspots.py: シンボリケーションとトップアプリフレームのランキングを行います。
注意点
- ASLR のため、
vmmapからランタイムの__TEXTロードアドレスを使用する必要があります。 - 新しいビルドを使用する場合は、
--binaryパスを更新してください。シンボルはトレースと一致している必要があります。 - CLI のみのフロー:
atosを介してスタックがシンボリケーションされるため、Instruments を開く必要はありません。