# Appstore Archive Uploader

> App Store IPA/PKG archives: set version/build numbers, archive, export, upload, or publish with `asc xcode` before TestFlight/App Store submission.

- Skill: `xopoko/appstore-archive-uploader` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add xopoko/appstore-archive-uploader`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xopoko/appstore-archive-uploader/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Xopoko (https://skillmd.com/u/xopoko)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xopoko/appstore-archive-uploader

---


# App Store Archive Uploader

Before invoking Apple-only binaries, confirm the execution context is macOS. From Windows or Linux, run those steps in a Mac SSH project or through an already configured remote transport; do not retry missing Apple binaries locally.

Prefer `asc xcode archive` and `asc xcode export` over raw `xcodebuild` when they fit.

## Preconditions

Xcode/CLT installed; signing identity/profiles or automatic signing available; ASC auth configured for upload/build lookup.

## Version And Build

```bash
asc xcode version view
asc xcode version edit --version "1.3.0" --build-number "42"
asc xcode version bump --type build
asc xcode version bump --type patch
asc builds next-build-number --app "APP_ID" --version "1.2.3" --platform IOS --output json
asc xcode version edit --build-number "NEXT_BUILD"
```

Use `--project-dir`, `--project`, and `--target` for multi-project/target determinism.

## iOS/tvOS/visionOS

```bash
asc xcode archive --workspace "App.xcworkspace" --scheme "App" --configuration Release \
  --clean --archive-path ".asc/artifacts/App.xcarchive" \
  --xcodebuild-flag=-destination --xcodebuild-flag=generic/platform=iOS --output json

asc xcode export --archive-path ".asc/artifacts/App.xcarchive" \
  --export-options "ExportOptions.plist" --ipa-path ".asc/artifacts/App.ipa" \
  --xcodebuild-flag=-allowProvisioningUpdates --output json
```

Use `--project "App.xcodeproj"` for project-only apps. Add `--wait` to export/upload/publish when the next step depends on processed builds.

Upload/distribute:

```bash
asc builds upload --app "APP_ID" --ipa ".asc/artifacts/App.ipa" --wait
asc publish testflight --app "APP_ID" --ipa ".asc/artifacts/App.ipa" --group "GROUP_ID" --wait
asc publish appstore --app "APP_ID" --ipa ".asc/artifacts/App.ipa" --version "1.2.3" --wait
asc publish appstore --app "APP_ID" --ipa ".asc/artifacts/App.ipa" --version "1.2.3" --wait --submit --confirm
```

## macOS App Store

```bash
asc xcode archive --project "MacApp.xcodeproj" --scheme "MacApp" --configuration Release \
  --clean --archive-path ".asc/artifacts/MacApp.xcarchive" \
  --xcodebuild-flag=-destination --xcodebuild-flag=generic/platform=macOS --output json

xcodebuild -exportArchive -archivePath ".asc/artifacts/MacApp.xcarchive" \
  -exportPath ".asc/artifacts/MacAppExport" -exportOptionsPlist "ExportOptions.plist" \
  -allowProvisioningUpdates

asc builds upload --app "APP_ID" --pkg ".asc/artifacts/MacAppExport/MacApp.pkg" \
  --version "1.0.0" --build-number "123" --wait
```

PKG uploads require explicit `--version` and `--build-number`.

## Fallback And Troubleshooting

- Use raw `xcodebuild` only when `asc xcode archive/export --help` cannot cover an option; try `--xcodebuild-flag` first.
- No profiles: add `--xcodebuild-flag=-allowProvisioningUpdates`, verify Xcode account/profiles, or use `appstore-signing-setup`.
- Build number too low: resolve `asc builds next-build-number`, edit, rebuild, upload.
- Missing macOS icon: fix ICNS/asset catalog sizes, rebuild, export/upload.
- Use `--overwrite` only when intentionally replacing local artifacts.
- For submission readiness, use `appstore-review-readiness`.