菜单
Capture screenshots and screen recordings from an iOS Simulator using xcrun simctl. Use when the user asks to take iOS screenshots, capture iOS screens, record iOS video, create iOS app visuals, generate iOS documentation images, or mentions simctl screenshots.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Planner-Generator-Evaluator harness for large, multi-screen features or major refactors. Separates planning, implementation, and evaluation into distinct phases with isolated context, preventing self-grading bias and context drift. Use when the user asks to build a large feature, do a major refactor, or implement something spanning multiple screens/files.
Unified release for both Android and iOS from a single version tag. Runs quality gates, bumps both platform versions in one commit, tags, builds both platforms, uploads Android to Play Store, and opens iOS archive for App Store upload. Use when the user asks to release, ship, cut a release, or make a new version.
Build and upload an Android release based on an existing git tag. Runs lint and all tests first (unit and instrumented), bumps version to match the tag, builds release AAB and APK (without debug info), commits the version bump, and uploads the AAB to Google Play Store internal testing. Use when the user asks to make an Android release, build for Play Store, or upload to Google Play.
Create a GitHub release with a version tag and auto-generated release notes. Does not build artifacts or upload to any store. Use when the user asks to tag a version, create a GitHub release, cut a release, or prepare release notes.
Build an iOS release based on an existing git tag. Bumps version to match the tag, builds the shared KMP framework and the iOS app archive. Use when the user asks to make an iOS release, build for App Store, or create an iOS archive.
Add translated strings and plurals to Android and iOS locale files. Use when adding new user-facing strings or plurals, fixing MissingTranslation lint errors, or when the user asks to translate, localize, or add strings to all languages.
| name | ios-screenshot-capture |
| description | Capture screenshots and screen recordings from an iOS Simulator using xcrun simctl. Use when the user asks to take iOS screenshots, capture iOS screens, record iOS video, create iOS app visuals, generate iOS documentation images, or mentions simctl screenshots. |
Capture screenshots and screen recordings from a running iOS Simulator using xcrun simctl.
/Applications/Xcode.appxcrun simctl list devices booted)SIM_UUID=$(xcrun simctl list devices booted -j | python3 -c "import sys,json; devs=json.load(sys.stdin)['devices']; print([d['udid'] for ds in devs.values() for d in ds if d['state']=='Booted'][0])")
echo $SIM_UUID
If no simulator is booted:
xcrun simctl boot <DEVICE_UUID>
open -a Simulator
xcrun simctl io $SIM_UUID screenshot output.png
The file is written directly to the local filesystem. PNG format by default.
iOS Simulator navigation is more limited than ADB. The recommended approach is a combination of techniques:
Accessibility inspector (find element coordinates):
# Use Accessibility Inspector.app (ships with Xcode) for element discovery
open -a "Accessibility Inspector"
Point the inspector at the Simulator window to find element positions and accessibility identifiers.
Keyboard shortcuts in Simulator:
Cmd+Shift+H — Home buttonCmd+Left/Right — Rotate devicesimctl status bar (clean screenshots):
xcrun simctl status_bar $SIM_UUID override \
--time "9:41" \
--batteryState charged \
--batteryLevel 100 \
--cellularMode active \
--cellularBars 4
Reset after capturing:
xcrun simctl status_bar $SIM_UUID clear
The iOS app uses a tab bar with four tabs (Play, Create, Learn, Reference). Each tab opens a menu-style NavigationStack with rows for each screen. Settings is accessible via a gear icon in each tab's toolbar.
| Tab | Screens |
|---|---|
| Play | Explorer, Tuner, Pitch Monitor, Metronome, Chord Library, Favorites |
| Create | Songbook, Melody Notepad, Strumming Patterns, Chord Progressions |
| Learn | Progress, Daily Challenge, Practice Routine, Achievements, Play Along, Chord Transitions, Theory Lessons, Theory Quiz, Interval Trainer, Note Quiz, Chord Ear Training, Scale Practice |
| Reference | Capo Guide, Circle of Fifths, Chord Substitutions, Scale Chords, Fretboard Note Map, Glossary |
To navigate: tap a tab at the bottom, then tap a row in the menu list.
# Start recording (sends SIGINT to stop)
xcrun simctl io $SIM_UUID recordVideo --codec=h264 output.mp4 &
PID=$!
# ... perform interactions ...
sleep 10
# Stop recording
kill -INT $PID
wait $PID 2>/dev/null
For capturing multiple screens (e.g., for documentation or a manual):
SIM_UUID=$(xcrun simctl list devices booted -j | python3 -c "import sys,json; devs=json.load(sys.stdin)['devices']; print([d['udid'] for ds in devs.values() for d in ds if d['state']=='Booted'][0])")
BUNDLE_ID=com.baijum.ukufretboard.ios
OUT_DIR=docs/manual/ios/screenshots
# Ensure app is installed and running
xcrun simctl launch $SIM_UUID $BUNDLE_ID
sleep 3
# Set clean status bar
xcrun simctl status_bar $SIM_UUID override \
--time "9:41" --batteryState charged --batteryLevel 100 \
--cellularMode active --cellularBars 4
# Navigate to each screen manually (tab bar + row taps) and capture:
# After navigating to Explorer:
xcrun simctl io $SIM_UUID screenshot $OUT_DIR/explorer-fretboard.png
# After navigating to Tuner:
xcrun simctl io $SIM_UUID screenshot $OUT_DIR/tuner.png
# ... continue for each screen ...
# Reset status bar
xcrun simctl status_bar $SIM_UUID clear
Use <section>-<description>.png:
explorer-fretboard.pngsettings-panel.pngchords-library.png| Task | Command |
|---|---|
| Screenshot | xcrun simctl io <UUID> screenshot file.png |
| Record video | xcrun simctl io <UUID> recordVideo file.mp4 |
| List booted devices | xcrun simctl list devices booted |
| Boot simulator | xcrun simctl boot <UUID> |
| Shutdown simulator | xcrun simctl shutdown <UUID> |
| Install app | xcrun simctl install <UUID> <path.app> |
| Launch app | xcrun simctl launch <UUID> <bundle-id> |
| Terminate app | xcrun simctl terminate <UUID> <bundle-id> |
| Override status bar | xcrun simctl status_bar <UUID> override --time "9:41" |
| Clear status bar | xcrun simctl status_bar <UUID> clear |
| Open Simulator GUI | open -a Simulator |
| Open Accessibility Inspector | open -a "Accessibility Inspector" |
Simulator screenshots are typically larger than App Store required dimensions and need resizing via sips.
| Display | Portrait | Landscape |
|---|---|---|
| iPhone 6.7" (Pro Max) | 1290 × 2796 | 2796 × 1290 |
| iPhone 6.5" | 1284 × 2778 or 1242 × 2688 | 2778 × 1284 or 2688 × 1242 |
| iPad 13" | 2048 × 2732 or 2064 × 2752 | 2732 × 2048 or 2752 × 2064 |
| Display | Simulator |
|---|---|
| iPhone 6.7" / 6.5" | iPhone 16 Pro Max |
| iPad 13" | iPad Pro 13-inch (M4 or M5) |
# Check captured dimensions
sips -g pixelWidth -g pixelHeight screenshot.png
# Resize to iPhone 6.5" (1284x2778)
sips -z 2778 1284 screenshot.png
# Resize to iPhone 6.7" (1290x2796)
sips -z 2796 1290 screenshot.png
# Resize to iPad 13" (2048x2732)
sips -z 2732 2048 screenshot.png
Note: sips -z takes height first, then width.
mkdir -p appstore/6.5 appstore/6.7 appstore/ipad-13
for f in screenshots/*.png; do
name=$(basename "$f")
cp "$f" "appstore/6.5/$name" && sips -z 2778 1284 "appstore/6.5/$name" >/dev/null
cp "$f" "appstore/6.7/$name" && sips -z 2796 1290 "appstore/6.7/$name" >/dev/null
done
# iPad screenshots (captured from iPad simulator) go to ipad-13
for f in ipad-screenshots/*.png; do
name=$(basename "$f")
cp "$f" "appstore/ipad-13/$name" && sips -z 2732 2048 "appstore/ipad-13/$name" >/dev/null
done
iPad screenshots captured from iPad Pro 13-inch simulators are typically 2064x2752, which is already an accepted App Store dimension and may not need resizing.
xcrun simctl boot <UUID> && open -a Simulator.sleep 2 before capturing.xcrun simctl list devices booted to find the correct UUID.xcrun simctl status_bar ... override before capturing for clean screenshots.xcrun simctl erase <UUID>.