Cannot Detect iOS Simulators

If your Finalrun application is unable to detect or list iOS simulators, this guide will help you resolve the underlying issue.

To quickly check why Finalrun is not detecting simulators, open your Terminal.app and run the following command:

xcrun simctl list devices

• If this command successfully returns a list of simulators, the issue might be specific to Finalrun (please contact our support team).

• If this command fails with an error like xcrun: error: unable to find utility "simctl", it indicates that the necessary Xcode Command Line Tools are missing or misconfigured on your system. This is the most common reason Finalrun cannot find simulators.

Follow the steps below to fix this configuration.

Step 1: Verify Xcode Installation & Path

Ensure Xcode is installed and its developer directory is properly recognized by your system.

xcode-select -p

• Expected: A path like /Applications/Xcode.app/Contents/Developer (or similar valid path).

• Action if Missing/Incorrect: If no path is returned or it's invalid, install Xcode from the Mac App Store. Launch Xcode at least once to complete its initial setup.

Step 2: Install/Reinstall Command Line Tools (CLT)

Install or refresh the necessary command-line tools that include simctl.

xcode-select --install

• Expected: A software update pop-up will appear, asking you to install. Click "Install".

• Note: If it says tools are "already installed," you can proceed directly to Step 3.

Step 3: Point to the Correct Developer Directory

Ensure your system is explicitly using the correct Xcode developer directory. This helps resolve path conflicts.

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

• Important: If your Xcode is installed in a non-standard location, replace /Applications/Xcode.app/Contents/Developer with the actual path to your Xcode's Contents/Developer folder.

Step 4: Verify Simulator Detection (System-Wide)

Confirm that simctl is now accessible and can list simulators on your system.

1. Crucial: Close and reopen your Terminal.app (and any IDEs or other development tools you might have open).

2. Run:

   xcrun simctl list devices

   • Expected: You should now see a detailed list of available iOS simulators. This confirms your system can properly interact with simulators.

---

Final Step: Verify Finalrun App Functionality

1. Quit and Relaunch the Finalrun application completely.

2. Check the simulator selection area within Finalrun. You should now see the list of available iOS simulators.

If issues persist, please contact [e-mail] with details of your macOS/Xcode versions and any output from the xcrun simctl list devices command.