GuidesConnect Your Device to Xcode with Corellium

Connect Your Device to Xcode with Corellium

How to use Xcode with your virtual iOS-based devices as part of your iOS testing and development processes.

We give a step-by-step guide on how to connect a device to Xcode using Corellium. Click the blog to get started with your iOS testing & development processes

To use Xcode, you need to have USBFlux set up first, check out the Connect to a Virtual iOS Device with USBFlux article if you haven't already.


Sync Caches Faster

If this is your first time connecting to the device, Xcode will begin copying a cache from the device. Whenever you connect a new device to Xcode, a dyld_shared_cache is downloaded from the device to Xcode in preparation for development. These files can be up to 3 GB, and downloading these files over Wi-Fi Sync or USBFlux can take a very long time. To expedite this process, you can use this free tool.

This tool first generates a list of devices connected via USB. Then, it enables you to locally download the appropriate caches for Xcode and install them in the correct location, rather than copying the caches from the device itself. This tool substantially speeds up the download process.


USBFlux

  1. Once you have USBFlux set up and running, open Xcode

  2. Select "Devices and Simulators" under the "Window" menu in the top navigation bar.

  3. Your virtual device will automatically appear as a Connected Device in the left-hand panel. You'll see a "CORELLIUM" serial number in the main window, as well as the iOS version and device model.


Wi-Fi Sync - Cloud Only

To pair your virtual device with Xcode using Wi-Fi Sync, you will first need to enable IPv6 for your VPN configuration profile in your VPN client. If you are using Viscosity, you can do this by selecting the VPN profile, then clicking "Edit," and then checking the box for "Enable IPv6."

Before proceeding, ensure that you are connected to the correct VPN configuration profile for your Project. It is recommended to have only one virtual iOS device in your Project. Multiple devices can cause Xcode to error.

  1. Continuing from the tutorial above, in the main screen of the Xcode device window, check the box for "Connect via Network."

  2. On the USBFlux app, click "Stop."

  3. In Xcode, your device should now appear as a Discovered Device with a sphere icon in the left-hand panel.

    1. If it does not appear, you may need to quit and reopen Xcode, and relaunch the "Devices and Simulators" window.

  4. Click on your device, and then click the "Pair with iPhone" button. The code is 000-000. Click "Connect."

  5. Your device should now appear as a Connected Device. It may take a minute for Xcode to update the device status. If it does not reappear, you may need to quit and reopen Xcode, and relaunch the "Devices and Simulators" window.

    1. Once connected, the Xcode device window may say Error: iPhone is locked. This error message does not prevent use of the device and can be ignored.


Troubleshooting Tips

  • If you are in the cloud, always ensure you are connected to VPN with the correct configuration profile.

  • For Wi-Fi Sync, "Error: iPhone is locked" can be ignored.

  • If a device is not detected properly, try closing and reopening Xcode.

  • It is not recommended to have multiple virtual devices running at once for this process. If you need to switch between virtual devices, you may need to force stop and restart usbmuxd.

Author

JS

Jasmine Singleton