Available devices and OS versions
Every mobile run can target a specific device model and OS version. In the run dialog, choose a Target, then select a Model and OS version. If you do not change the selection, BugRadar uses the newest model and OS.
The device picker shows the exact model and OS combinations available for your app. iOS Simulator versions marked Fast launch use an optimized startup path; every listed combination is supported.
For API runs, use List Devices to retrieve the current catalog, then pass one of the returned combinations in the run’s
device object.
Physical Device Testing
Run any mobile flow on real hardware — actual iPhones, Pixels, and Galaxy devices — instead of an emulator or simulator. Same flows, same agent, real devices.Build requirements
What you can run depends on the build you upload:
For iOS, upload an
.ipa built for physical devices. Android builds work on both targets with no changes.
Running on a real device
- Dashboard
- API
Click Run on a flow (or suite), set Target to Real device, and pick a device model and OS version. The picker lists the live device catalog, newest models first, and defaults to the newest available device. If that device is busy, the run moves to the closest free device instead of failing. To keep the model or OS fixed, set
match through the API (see Picking a device) or the CI action.If your app’s default build is an .ipa, the dialog opens on Real device automatically.Real device stays visible but disabled when your organization has no real-device access or your app has no compatible build. Hover over or keyboard-focus the option to see why. For access, contact founders@usebugradar.com; for an iOS simulator-only app, upload an .ipa.Picking a device
Thedevice object narrows which device the run lands on:
-
model— e.g."iPhone 16 Pro","Pixel 9", or"latest". Matches the names shown in the dashboard picker. -
physical— usetruefor real hardware; it defaults tofalse. -
os_version—"18"matches any 18.x;"18.3.1"matches only that version;"latest"keeps it rolling. -
match— per field,"similar"(the default) or"exact", for example{"os_version": "exact"}. When the pinned device is busy, the run moves to the closest free phone or tablet: same model on another OS first, then the same brand, closest OS and generation. A field set to"exact"never changes, so{"os_version": "exact"}means any model on that OS, preferring the one you pinned.
What you get
Real-device runs flow through the same pipeline as every other run:- Full video recording of the session, with per-action replay markers
- Screenshots and annotations for every agent action
- Device identity on the run page — the exact model and OS the run executed on (e.g.
Pixel 9 · Android 16 · Real device) - Suites share one device session across their flows, so back-to-back flows start fast
Real-device runs take ~1–2 minutes longer to start than emulator runs while a device is acquired, and iOS sessions take a few extra minutes to finalize their video after the run completes.