Skip to main content
Export .app files from Xcode for testing on Revyl.

​
Quick Steps

  1. Open your project in Xcode
  2. Select any iOS Simulator as destination
  3. Product → Build (⌘+B)
  4. Product → Show Build Folder in Finder
  5. Navigate to Debug-iphonesimulator/YourApp.app

​
Building Your App

​
Select Simulator

In Xcode toolbar:
  • Choose your app scheme
  • Select any iOS Simulator (e.g., iPhone 15 Pro)
The specific simulator doesn’t matter - builds are universal.

​
Build

  1. Clean: Product → Clean Build Folder (⌘+Shift+K)
  2. Build: Product → Build (⌘+B)
  3. Wait for success

​
Locate Build

Product → Show Build Folder in Finder Navigate to: 
Build/Products/Debug-iphonesimulator/YourAppName.app
Important: Use Debug-iphonesimulator, NOT Debug-iphoneos.

​
Test Before Upload

  1. Open iOS Simulator
  2. Drag YourApp.app onto simulator window
  3. Launch from home screen
  4. Verify it works
Always test locally before uploading.

​
Command Line

For CI/CD pipelines: 
# Clean
xcodebuild clean -scheme YourScheme -configuration Debug

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

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

​
Troubleshooting

​
Signing Errors

Simulator builds don’t need code signing:
  • Set Code Signing Identity to “Don’t Code Sign”
  • Or enable Automatically manage signing

​
Architecture Issues

Ensure compatibility with Apple Silicon and Intel:
  1. Select your target → Build Settings
  2. Find Architectures
  3. Verify: Standard Architectures (arm64) - $(ARCHS_STANDARD)
This includes both arm64 and x86_64 automatically.

​
App Won’t Install

  • Drag the .app file directly (not a folder)
  • Restart iOS Simulator
  • Check simulator iOS version matches deployment target

​
Build Folder Missing

Manual path: 
~/Library/Developer/Xcode/DerivedData/[ProjectName]/Build/Products/Debug-iphonesimulator/

​
Next Steps

Upload your build to Revyl:
  • Go to Builds page
  • Click Create Build
  • Select iOS platform
  • Upload your .app file
Need help? Contact [email protected]