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:
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:

​
Authenticated Test States

Revyl launch variables are available to iOS simulator apps as launch arguments such as -REVYL_AUTH_BYPASS_TOKEN <token>. Use them to gate a test-only myapp://revyl-auth deep link. See Auth Bypass Deep Links for the Swift snippet.

​
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:

​
Next Steps

Upload your build to Revyl:
  • Go to Builds page
  • Click Create Build
  • Select iOS platform
  • Upload your .app file