> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revyl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# iOS Simulator Builds

> Create iOS simulator builds using Xcode

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:

```bash theme={null}
# 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/*"
```

## 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](/builds/auth-bypass-deeplinks#framework-recipes) 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:

```
~/Library/Developer/Xcode/DerivedData/[ProjectName]/Build/Products/Debug-iphonesimulator/
```

## Next Steps

Upload your build to Revyl:

* Go to [Builds page](/builds/index)
* Click **Create Build**
* Select **iOS** platform
* Upload your `.app` file