Interacting with your app in Device Hub
Use Device Hub to control interactions with your apps on simulated and physical devices.
Overview
You use similar controls on your Mac to interact with your app on a simulated and physical device that appears in the Device Hub canvas.
When you launch your app on a simulated device, Device Hub opens to show the device screen in a compact window. When you launch your app on a physical device, Xcode runs it on the device. To interact with the device in Device Hub, select the device in the sidebar and click View Screen in the canvas area.
Device Hub surrounds the screen content with a bezel that resembles the target device. In visionOS, it displays a synthetic space to mimic the experience someone would have when they wear the device. Each device bezel and space has specific controls to support interactions.
Interact with your iOS or iPadOS app in the canvas
Use your Mac’s pointer, trackpad or Magic Mouse, keyboard, menu items, and buttons to make gestures on a simulated iOS or iPadOS device.
Gesture | To simulate |
|---|---|
Tap | Click. |
Double-tap | Double-click. |
Touch and hold | Click and hold. |
Drag and drop | Click and hold until the drag item appears, then drag the item to the target. |
Activate Siri | Hold the Sleep/Wake button on the device bezel or choose Controls > Siri. |
Rotate the simulator to the left | Click the rotate button under the device bezel or choose Controls > Rotate Left. |
Rotate the simulator to the right | Option-click the rotate button under the device bezel or choose Controls > Rotate Right. |
Set the orientation of the device | Choose an orientation from the Device > Orientation submenu. Face Up and Face Down do not rotate the simulator. |
Activate device buttons by clicking on parts of the device bezel:
Button | To simulate |
|---|---|
Click the Home button | Click the Home button below the device bezel or choose Controls > Home. |
Click the Sleep/Wake button | Click the Sleep/Wake button on the device bezel or choose Controls > Lock. |
Click or hold Volume up | Click or hold the Volume Up button on the device bezel or choose Device > Sound > Increase Volume. |
Click or hold Volume down | Click or hold the Volume Down button on the device bezel or choose Device > Sound > Decrease Volume. |
Click the Action button | Click the Action button on the device bezel. |
Interact with your watchOS app in the canvas
Use the pointer, trackpad or Magic Mouse, keyboard, and menu items to make gestures on a simulated watchOS device.
Gesture | To simulate |
|---|---|
Tap | Click. |
Double-tap | Double-click |
Touch and hold | Click and hold |
Activate Siri | Hold the Sleep/Wake button on the device bezel or choose Controls > Siri. |
Activate device buttons using menu items or by clicking on parts of the device bezel:
Button | To simulate |
|---|---|
Push in the Digital Crown | Click the Digital Crown on the device bezel. |
Rotate the Digital Crown clockwise or counterclockwise | Place the pointer over the Digital Crown on the device bezel and scroll using a mouse wheel or trackpad. If the bezel is hidden, move the pointer over the simulator window, then scroll using a mouse wheel or trackpad. |
Click the Side button | Click the Side button on the device bezel. |
Click the Action button | Click the Action button on the device bezel or choose Controls > Action Button. |
Interact with your tvOS app in the canvas
Use the pointer, keyboard, and menu items to make gestures on a simulated tvOS device.
Gesture | To simulate |
|---|---|
Move the focus to the left | Press the Left Arrow key. |
Move the focus to the right | Press the Right Arrow key. |
Move the focus up | Press the Up Arrow key. |
Move the focus down | Press the Down Arrow key. |
Trigger the action for the current focus | Press the Return key. |
Move up one level in the navigation hierarchy | Press the Escape key. |