Xcode

​

Step 1: Open Your Project in Xcode

1. Launch Xcode
2. Open your iOS project by selecting File > Open and navigate to your .xcodeproj or .xcworkspace file
3. Wait for Xcode to finish loading and indexing your project

​

Step 2: Select Scheme and Simulator

1. In the Xcode toolbar, locate the scheme and destination selector (next to the play/stop buttons)
2. Choose an appropriate scheme for your app from the dropdown
3. Select any iOS Simulator from the destination list (e.g., “iPhone 15 Pro”)

​

Step 3: Build Your App

1. Clean your project first: Product > Clean Build Folder (⌘+Shift+K)
2. Build your app: Product > Build (⌘+B)
3. Wait for the build to complete successfully

​

Step 4: Locate Your Build

1. In Xcode, choose Product > Show Build Folder in Finder
2. A Finder window will open showing your build products
3. Navigate to: Build/Products/Debug-iphonesimulator/
4. Look for your app file: YourAppName.app

​

Step 5: Verify Your Build

1. Open iOS Simulator (you can find it in Applications or launch via Xcode)
2. Drag your .app file directly onto the simulator window
3. The app should install automatically
4. Launch the app from the simulator home screen to verify it works correctly

​

Alternative: Command Line Build

# Navigate to your project directory
cd /path/to/your/project

# Clean previous builds
xcodebuild clean -scheme YourScheme -configuration Debug

# Build for simulator
xcodebuild build \
  -scheme YourScheme \
  -configuration Debug \
  -destination 'platform=iOS Simulator,name=iPhone 15 Pro'

# Locate the build
find ~/Library/Developer/Xcode/DerivedData -name "*.app" -path "*/Debug-iphonesimulator/*"

​

Next Steps

1. Check out Uploading your app for more detailed instructions on how to upload your new build!

​

Troubleshooting

​

Additional Resources

• Apple’s Xcode Build Documentation
• iOS Simulator Guide
• Xcode Build Settings Reference