🎯

asc-xcode-build

🎯Skill

from rudrankriyam/app-store-connect-cli-skills

What it does

Builds and exports iOS/macOS apps using xcodebuild, generating IPA or PKG files ready for App Store Connect upload.

📦

Part of

rudrankriyam/app-store-connect-cli-skills(10 items)

asc-xcode-build

Installation

Quick InstallInstall with npx

npx add-skill rudrankriyam/app-store-connect-cli-skills

📖 Extracted from docs: rudrankriyam/app-store-connect-cli-skills

Need more details? View full documentation on GitHub →

11Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Build, archive, and export iOS/macOS apps with xcodebuild before uploading to App Store Connect. Use when you need to create an IPA or PKG for upload.

Overview

# Xcode Build and Export

Use this skill when you need to build an app from source and prepare it for upload to App Store Connect.

Preconditions

Xcode installed and command line tools configured
Valid signing identity and provisioning profiles (or automatic signing enabled)

iOS Build Flow

1. Clean and Archive

```bash

xcodebuild clean archive \

-scheme "YourScheme" \

-configuration Release \

-archivePath /tmp/YourApp.xcarchive \

-destination "generic/platform=iOS"

```

2. Export IPA

```bash

xcodebuild -exportArchive \

-archivePath /tmp/YourApp.xcarchive \

-exportPath /tmp/YourAppExport \

-exportOptionsPlist ExportOptions.plist \

-allowProvisioningUpdates

```

A minimal ExportOptions.plist for App Store distribution:

```xml

method

app-store-connect

teamID

YOUR_TEAM_ID

```

3. Upload with asc

```bash

asc builds upload --app "APP_ID" --ipa "/tmp/YourAppExport/YourApp.ipa"

```

macOS Build Flow

1. Archive

```bash

xcodebuild archive \

-scheme "YourMacScheme" \

-configuration Release \

-archivePath /tmp/YourMacApp.xcarchive \

-destination "generic/platform=macOS"

```

2. Export PKG

```bash

xcodebuild -exportArchive \

-archivePath /tmp/YourMacApp.xcarchive \

-exportPath /tmp/YourMacAppExport \

-exportOptionsPlist ExportOptions.plist \

-allowProvisioningUpdates

```

3. Upload PKG

macOS apps export as .pkg files. Use xcrun altool:

```bash

xcrun altool --upload-app \

-f "/tmp/YourMacAppExport/YourApp.pkg" \

--type macos \

--apiKey "$ASC_KEY_ID" \

--apiIssuer "$ASC_ISSUER_ID"

```

Note: The API key file must be in ~/.appstoreconnect/private_keys/AuthKey_.p8

Build Number Management

Each upload requires a unique build number higher than previously uploaded builds.

In Xcode project settings:

CURRENT_PROJECT_VERSION - build number (e.g., "316")
MARKETING_VERSION - version string (e.g., "2.2.0")

Check existing builds:

```bash

asc builds list --app "APP_ID" --platform IOS --limit 5

```

Troubleshooting

"No profiles for bundle ID" during export

Add -allowProvisioningUpdates flag
Verify your Apple ID is logged into Xcode

Build rejected for missing icon (macOS)

macOS requires ICNS format icons with all sizes:

16x16, 32x32, 128x128, 256x256, 512x512 (1x and 2x)

CFBundleVersion too low

The build number must be higher than any previously uploaded build. Increment CURRENT_PROJECT_VERSION and rebuild.

Notes

Always clean before archive for release builds
Use xcodebuild -showBuildSettings to verify configuration
For submission issues (encryption, content rights), see asc-submission-health skill

More from this repository9

🎯

asc-release-flow🎯Skill

Streamlines iOS and macOS app releases by automating build uploads, TestFlight distribution, and App Store submission processes.

🎯

asc-id-resolver🎯Skill

Resolves App Store Connect IDs by translating human-friendly names to precise identifiers for apps, builds, versions, groups, and testers.

🎯

asc-metadata-sync🎯Skill

Synchronizes and validates App Store Connect metadata and localizations across different locales and version releases.

🎯

asc-submission-health🎯Skill

Preflight and monitor App Store submission health, ensuring builds meet Apple's requirements and reducing review submission failures.

🎯

asc-testflight-orchestration🎯Skill

Orchestrates TestFlight distribution by managing beta groups, testers, builds, and release notes using Apple's App Store Connect CLI.

🎯

asc-build-lifecycle🎯Skill

Manages Apple Store Connect build lifecycle by tracking, finding, processing, and cleaning up builds across different platforms and versions.

🎯

asc-cli-usage🎯Skill

Provides expert guidance for executing and designing App Store Connect CLI commands with best practices for flags, output, authentication, and command discovery.

🎯

asc-signing-setup🎯Skill

Configures iOS/macOS app signing assets like bundle IDs, certificates, and provisioning profiles using Apple's ASC CLI.

🎯

asc-ppp-pricing🎯Skill

Configures territory-specific subscription and in-app purchase prices using purchasing power parity (PPP) across different countries.