PrivateHeaderKit

日本語

Generate iOS private framework headers from simulator runtimes (dyld shared cache).

Usage

1) Dump headers

./scripts/dump_headers

2) Dump headers with args

./scripts/dump_headers 26.2

Default output directory is generated-headers/iOS/<version>. This dumps both Frameworks and PrivateFrameworks.

3) List runtimes / devices

./scripts/dump_headers --list-runtimes
./scripts/dump_headers --list-devices --runtime 26.0.1

Options

• --device <udid|name>: Choose a simulator device
• --out <dir>: Output directory
• --force: Always dump headers even if they already exist
• --exec-mode <host|simulator>: Force execution mode
• --framework <name>: Dump only the exact framework name (repeatable, .framework optional)
• --filter <substring>: Substring filter for framework names (repeatable)
• --layout <bundle|headers>: Output layout (bundle keeps .framework dirs, headers removes the .framework suffix)
• --list-runtimes: List available iOS runtimes and exit
• --list-devices: List devices for a runtime and exit (use --runtime)
• --runtime <version>: Runtime version for --list-devices
• --json: JSON output for list commands
• --shared-cache: Use dyld shared cache when dumping (enabled by default; set PH_SHARED_CACHE=0 to disable)
• --clean-build, --cleanbuild: Clear .build and rebuild headerdump
• --rebuild: Rebuild headerdump only

Notes

• Requires Python 3.
• Simulator mode uses xcrun simctl spawn.
• During dumping, raw output is staged under <out>/.tmp-<run-id> and then moved to the final layout.
• The output directory is locked for the duration of a run to avoid concurrent writes.
• Verbose mode suppresses skipped-class logs by default; set PH_VERBOSE_SKIP=1 to show them.
• You can override the device type used for auto-creation with PH_DEVICE_TYPE (device name or identifier).
• Environment overrides: PH_EXEC_MODE, PH_OUT_DIR, PH_FORCE=1|0, PH_SKIP_EXISTING=1|0, PH_LAYOUT, PH_SHARED_CACHE=1|0, PH_VERBOSE_SKIP=1, PH_DEVICE_TYPE, PH_REBUILD_HEADERDUMP=1

License

• MIT for this workspace: see LICENSE.