abdullah4ai/asc-screenshot-upload

ASC Screenshot Upload

Two-Option Screenshot System

During pre-flight step 8, the user chooses how to provide screenshots:

Automatic (Recommended)

Pre-flight builds the app for each required simulator, boots them, installs, launches, and captures the initial launch screen. Simulators are left running so you can capture additional screens.

After pre-flight, use AXe to navigate to key screens and capture more:

# See current screen elements
axe describe-ui --udid <UDID>

# Navigate to a screen
axe tap --id <element_id> --udid <UDID>

# Capture screenshot
xcrun simctl io <UDID> screenshot <path>.png

Analyze the app's Swift source to identify important screens (ignore settings/preferences). Capture 3-5 screenshots showing the app's core functionality.

Custom Upload

Browser UI with Apple validation:

• Requirements checklist at top shows which device types are needed (green checkmarks when fulfilled)
• Each uploaded image shows a badge: green with device type if dimensions match, red "Invalid size" if not
• Upload Screenshots button disabled until all required types have valid screenshots
• Upload Anyway escape hatch for incomplete uploads
• Summary line: "2/2 required types covered" or "1/2 — iPad 13" still needed"

Device Family Requirements

The device_family field in project_config.json determines what's required:

| Device Family | Required Screenshots | |---|---| | iphone (default) | iPhone 6.9" (or 6.5" fallback) | | ipad | iPad 13" | | universal | iPhone 6.9" AND iPad 13" |

iPad screenshots are mandatory for universal/iPad apps. Submission will fail without them.

Apple Screenshot Dimensions

| Device | Resolution (portrait) | Device Type | |---|---|---| | iPhone 6.9" | 1320x2868, 1290x2796, 1260x2736 | IPHONE_69 | | iPhone 6.5" (fallback) | 1284x2778, 1242x2688 | IPHONE_65 | | iPad 13" | 2064x2752, 2048x2732 | IPAD_PRO_13 |

Format: PNG or JPEG, RGB, no transparency. 1-10 screenshots per device type per locale.

Screenshot Directory Convention

screenshots/
  auto/       # Automatic simulator captures
  upload/     # User-provided screenshots from browser upload
  framed/     # Framed screenshots ready for upload

Uploading to App Store Connect

# Get the version localization ID
asc localizations list --version "VERSION_ID" --output json

# Upload screenshots
asc screenshots upload \
  --version-localization "LOC_ID" \
  --path "./screenshots/auto" \
  --device-type "IPHONE_69" \
  --output json

Screenshot Status in System Prompt

The system prompt reports screenshot status:

• available at <path> (device types: IPHONE_69, IPAD_PRO_13) — ready
• available at <path> (not yet validated) — found but unchecked
• NOT available — missing, required before submission

If automatic capture was used, simulator UDIDs are provided for multi-screen capture via AXe.