Article

Run and debug on a physical iPhone wirelessly in Xcode

This article covers one of the most practical Xcode quality-of-life features: once an iPhone is paired and trusted, you can stop keeping the cable attached and still launch, test, and debug over the local network.

Xcode iPhone Wireless Debugging Devices and Simulators Wi-Fi

Published on May 25, 2020. Updated on January 25, 2021.

Xcode Devices window showing the Connect via Network checkbox for a physical iPhone
Overview

This article is a short reminder that real-device testing does not have to mean leaving a cable on your desk all day.

If your Mac and iPhone are on the same local network, Xcode can keep talking to the device after the initial setup. That means fewer cables, easier device swapping, and less friction when you need to test on multiple phones.

What you need first Connect the device by cable once, make sure it is trusted, and keep both the Mac and iPhone on the same Wi-Fi network.
Why It Helps

This is a small feature, but it matters most when you test often and move between devices constantly.

This article frames it as a desk-cleanup problem, and that is accurate. If you work with several physical devices, cable-only testing turns into clutter fast. Wireless deployment removes one repetitive step without changing the way you already use Xcode.

Step 1

Open the Xcode device-management window from the run destination area.

Start from the same place you normally pick a simulator or physical device. From that menu, open the screen that manages simulators and connected hardware, then switch to the Devices side so you can inspect the iPhone directly.

Xcode run destination menu leading to the Devices and Simulators window
The path starts from the usual device picker in the Xcode toolbar.
Step 2

With the phone still attached by cable, select it and enable Connect via Network.

This is the key step. Xcode needs that first wired connection so it can register the device correctly. Once the device appears in the window, enable Connect via Network and let Xcode finish the setup.

Devices window with the Connect via Network setting enabled
After this is enabled, the cable is no longer required for everyday run-and-debug cycles.
Step 3

Unplug the cable, confirm the network icon appears, and run the app again.

Once the phone reconnects over Wi-Fi, Xcode shows a small network indicator next to the device. That is the signal that the device is still available as a run destination even without the cable attached.

Physical iPhone listed in Xcode with a network icon indicating wireless connection
The network icon is the quick visual check that wireless debugging is active.
Connect via Network option in Xcode devices settings
If the phone disappears later, revisit this setting and confirm both devices stayed on the same network.
Wrap Up

This article is brief, but the tip is worth keeping in your normal Xcode setup checklist.

Pair once by cable, enable Connect via Network, and then treat the phone almost like a wireless run target. For teams or solo developers testing across several iPhones, that small setup change removes a lot of needless plugging and unplugging.