Getting Started with Apple Vision Pro
Pairing Vision Pro with Xcode on Mac
Welcome to development for visionOS. The following guide walks you through pairing Apple Vision Pro with your Mac.
Before you start, familiarize yourself with the prerequisites below.
Prerequisites
Apple Vision Pro running visionOS 26.0 or later.
Follow the official guides on how to turn on, take on/off the device or switch between accessories.
A Mac running macOS Sequoia 15.3 or later with Xcode 26.0 or later installed.
Your Mac must operate on Apple Silicon (M1 or later) to pair with Vision Pro.
Along the guide, your Mac and Vision Pro must be connected on the same Wi-Fi network for pairing to successfully complete.
The “ZHdK” network at the university unfortunately won’t work for this process. Use a different network or connect both devices via personal hotspot.
Guide
Table of Contents
Finding Remote Devices
On Mac
Open Xcode.
In Xcode, navigate to and open Product/ Destination/ Manage Run Destinations.
A window appears, which let’s you add, manage or remove your devices and simulators.
On the side bar, select the Devices tab next to Simulators.
Under the Discovered section, select the row under which the Vision Pro is listed.
As soon as the device is selected, a visual preview of the Vision Pro appears on the right of the side bar, below of it a control to Pair.
Make sure that both the Mac and Vision Pro are on the same Wi-Fi network. You may also connect both via your personal hotspot.
If either your devices are not on the same network, or Remove Devices on Vision Pro are not opened, you may otherwise see No Selection next to the side bar.
On Apple Vision Pro
Open Settings.
In Settings, navigate to and open General/ Remote Devices.
The device is “Ready To Pair” and discoverable for Xcode to pair with your Mac.
As long as Remove Devices is open, Xcode is able to discover the Vision Pro under its device name.
Connecting to Remote Device
On Mac
To start pairing the discovered Vision Pro, click on Pair.
Xcode will prompt you to enter the verification code that is presented on the Vision Pro.
Enter the numbers from the alert shown on Vision Pro and click Connect.
On successful connection, Vision Pro moves from Discoverable to Connected section on the side bar.
On Apple Vision Pro
An alert titled and described Pair Device resp. Enter this verfication code on … appears.
On successful connection, your Mac under its device name gets listed on the Remove Devices section.
Enabling Developer Mode
By default, you cannot start building for any remote device right away because Developer Mode is switched off. To enable Developer Mode for Vision Pro, you continue with the steps below. Otherwise, you may skip this section.
On Mac
A yellow panel appears at the top of the window: Developer Mode disabled.
The yellow panel at the top of the window changes to Preparing …, then Copying shared cache symbols from … (0% completed).
Wait until the process of copying shared cache symbols reaches 100%.
After completion, the yellow panel disappears, and you have successfully paired Vision Pro with your Mac.
Happy coding and modeling!
On Apple Vision Pro
In Settings, navigate to and open Privacy & Security.
In Privacy & Security, scroll down to the Security section and select Developer Mode.
Switch the toggle on the Developer Mode row to on.
An alert appears, prompting to restart or abort.
Select Restart, wait until the device restarts and keep Vision Pro wearing.
It should take around half a minute for the device to restart. Afterwards, an alert titled Turn On Developer Mode? appears.
Select Turn On and enter the passcode you use to unlock Vision Pro.
Keep wearing Vision Pro until setup is complete. Make sure both your Mac and Vision Pro remain on the same network.
Troubleshoot
Should you enounter any issues along the way, do not hesitate to reach out to your technical instructor. You may also consult the references below.