Apple publishes separate system requirements for Xcode and release notes for Xcode 27, so compatibility and version-specific changes need to be checked before attempting a repair (Xcode system requirements, Xcode 27 release notes).
Simulator opens, but the device or app fails → check macOS compatibility and the runtime before reinstalling Xcode.
If you’re learning Swift or iOS development with Xcode 27, this guide helps you locate where the failure starts.
If a course project gets stuck during testing, you’ll be able to separate a project issue from a Simulator issue.
If you’re using Windows without a suitable Mac environment, the final section explains what to verify before choosing another setup.
Last updated October 15, 2026. Version and recovery guidance checked against Apple’s current Xcode system requirements, component installation documentation, and the release notes linked below. Requirements and available runtimes can change with updates, so check Apple’s current pages before acting.
Start by identifying where launch stops
The Simulator is like a test phone that runs on your Mac. It is useful for checking an app, but it is not a physical iPhone. A failure can happen before the virtual device appears, while the device is starting, or only after Xcode tries to run your project. Those are different problems, and they don’t call for the same fix.
Before changing anything, note what you see:
- The Simulator app does not open. Xcode might be unable to launch the app, or the installed macOS version might not support your Xcode release.
- The app opens, but no simulated device starts. The selected device may need a runtime that is missing, still downloading, or no longer available after an update.
- The device starts, but the project does not run. The run destination, target system version, build, installation, or app launch may be the issue.
- The failure began after an update. A new Xcode or macOS version may have changed compatibility or made a runtime unavailable.
Write down the exact error before trying a fix. “Simulator won’t open” can describe several stages, but an error shown during build is not the same as a device that stays on a boot screen.
First check Xcode and macOS compatibility
Start with compatibility. If the installed macOS version does not meet the requirements for your Xcode release, repeatedly downloading Simulator components is unlikely to solve the underlying problem.
Open Xcode’s version information and check the installed macOS version in System Settings. Then compare both with Apple’s Xcode system requirements. Use the requirements for the specific Xcode version installed on the Mac; don’t rely on a guide for an earlier release.
The Xcode 27 release notes are the place to check for changes and issues documented for that release. If the installed app is a later update, use the matching release notes where Apple provides them. The Xcode 27.1 release notes are specifically for the 27.1 release candidate, so don’t treat them as a substitute for notes that match a different installed build.
Compatibility matters in practice because there are several separate pieces:
- macOS is the operating system running the Mac.
- Xcode is the development app and toolset.
- Simulator runtime provides the simulated operating system for a device.
- Simulated device is a device model configured to run with an available runtime.
A Mac can have Xcode installed but still lack the runtime needed for the course project. Conversely, a runtime download won’t make an unsupported macOS version compatible with Xcode.
If the system requirements don’t match, pause before removing components or resetting devices. Check whether the Mac can be updated to a supported macOS version and whether that update is appropriate for the device. If it can’t meet the requirement, the next step is to assess another compatible Mac environment—not to keep repeating the same installation.
Check the Simulator runtime before changing devices
A device entry and its runtime are related, but they are not the same thing. Think of the device as a phone model and the runtime as the version of iOS that makes that test environment work. Selecting a device in Xcode does not necessarily mean its runtime is installed.
Open Xcode’s settings and inspect the components or platform section. Confirm that the required iOS Simulator runtime is listed as installed. Apple’s instructions for downloading and installing additional Xcode components explain how to obtain components that are not included with an Xcode installation. Apple also documents adding and managing simulators.
If the runtime is missing, download it through Xcode and let the installation finish before testing. A download that is still in progress is not a completed setup. While a needed component is unavailable, a project that depends on it may not build or run as expected.
If the runtime is not offered:
- Recheck which Xcode version is installed.
- Compare that version and macOS with Apple’s current requirements.
- Confirm that the selected project destination needs the runtime you’re checking.
- Check the applicable release notes for changes to runtime availability.
Don’t delete an existing device just because it appears in a list but won’t start. First confirm whether the needed runtime is present and whether Xcode recognizes it. Removing a device configuration is different from removing a runtime, and neither should be used as a first guess.
Recover a device that will not boot
When the Simulator app opens but a device does not reach its home screen, move from low-risk checks to more disruptive ones. Start by closing Simulators and apps you don’t need. Then quit and reopen Xcode and the Simulator. If the device still won’t start, restart the Mac and test again.
After an Xcode or macOS update, check the installed runtime again. A device configuration that existed before the update may no longer have a usable runtime. Verify the available devices and runtimes using Xcode’s settings and Apple’s Simulator management guidance.
For a command-line inventory, open Terminal and run:
xcrun simctl list devices available
This lists available simulated devices. It is a diagnostic view, not a repair command. The output depends on the Mac’s installed components, so treat the example below as a format illustration rather than a report from a specific machine:
== Devices ==
-- iOS --
Example Device (device identifier) (Shutdown)
If Xcode lists a device but it won’t boot, test another available device that uses an installed runtime. If that one starts, the original device configuration may be the narrower problem. If none start, return to compatibility and runtime checks before resetting anything.
Apple’s documentation covers restarting and resetting a simulated device in its guide to configuring the environment of a simulated device. Resetting a simulated device can remove data stored inside that device. It does not repair every underlying Xcode or macOS compatibility issue.
Before deleting a simulated device or runtime, confirm what will be removed. Keep your project files backed up separately; a Simulator reset and a project backup are not the same thing.
Separate Simulator problems from project problems
If the device boots, the Simulator itself may be working even if your app won’t run. Check the run destination selected by Xcode. It should match a device and runtime that are actually available. Then check the project’s deployment target: if the project expects a newer system than the chosen runtime provides, that mismatch may block installation or launch.
Pay attention to the point where the process stops:
- Build fails: Xcode has not finished preparing the app. Read the first useful error in the build output, and check the project settings and source code.
- Build succeeds, installation fails: Confirm that the selected destination is available and that the project can run on its operating-system version.
- Installation succeeds, launch fails: Look for an app startup error or a crash message. That is different from a device that cannot boot.
- The app runs on another destination: Compare the working and failing destinations. This can help show whether the problem is tied to a specific runtime or device configuration.
Apple’s guide to running an app on simulated or physical devices describes the run destination workflow. Follow it to confirm the destination selected for the project rather than assuming that the most recently used device is still valid.
A Simulator reset is not a general-purpose project repair. If the device opens and other apps run, resetting it may erase test data without fixing a build setting or code error. Likewise, reinstalling Xcode is a large step when the failure is isolated to one project. First determine whether the problem happens before build, during build, during installation, or at app launch.
Use this checklist before escalating
Work from the least disruptive check toward actions that could remove local state. Stop when the cause is clear.
- [ ] Record the exact Xcode version and macOS version shown on the Mac.
- [ ] Compare that combination with Apple’s current Xcode system requirements.
- [ ] Identify whether the Simulator app, device boot, build, installation, or app launch is failing.
- [ ] Confirm the required iOS Simulator runtime is installed and not still downloading.
- [ ] Check that the project’s run destination matches an available device and runtime.
- [ ] Close unused Simulator windows, reopen Xcode, and restart the Mac before attempting a reset.
- [ ] Review the release notes for the installed Xcode version and note any relevant documented issue.
- [ ] Save the error message and the steps already tried before asking for help.
This checklist gives a useful report for a course instructor or support request. Include the full error text, not just “it doesn’t work.” If the failure began after an update, say which component changed and whether the runtime still appears in Xcode settings.
Decide whether the Mac environment is the limiting factor
If the current Mac cannot meet the Xcode 27 system requirements, distinguish a hardware or operating-system limit from a project bug. A project can be configured correctly and still be blocked by an unsupported environment. In that situation, more Simulator resets are unlikely to change the compatibility boundary.
Compare the options based on what the course requires:
- Use the current Mac if it meets the applicable requirements and the necessary runtime is available.
- Borrow or use another Mac if you can confirm its macOS version, Xcode version, and access time will cover the course work.
- Consider a remote Mac if you need access to macOS for a limited period and don’t have a suitable local device. Before relying on it, verify the actual environment, how you’ll connect, and whether your project workflow is supported.
- Choose another learning route temporarily if the assignment does not yet require Xcode or Simulator testing. That can keep basic programming practice moving, but it won’t replace a required iOS build-and-test environment.
A remote session also depends on your internet connection and the environment’s available settings. We can’t guarantee that a particular remote setup will satisfy Xcode 27 requirements or solve a specific Simulator fault. Use the Mac environment comparison guide to review access options, then verify the environment details relevant to your course before switching.
Frequently asked questions
What should be checked first?
Check the macOS and Xcode compatibility requirements, then verify that the required iOS Simulator runtime is installed. After that, identify whether the app, device, or project is failing. Reinstalling Xcode before these checks can consume time without addressing the actual cause.
What if no iOS runtime is available?
Check Xcode’s components or platform settings and install the required runtime if it is offered. Wait until its installation finishes before running the project. If it is unavailable, compare the installed Xcode and macOS versions with Apple’s current requirements and review the matching release notes.
How do we tell a device fault from an app fault?
Try starting an available simulated device without launching the project. If the device boots, select it as the project’s run destination and observe whether the failure occurs during build, installation, or launch. A build error is not evidence that the Simulator device itself is broken.
What changes after a macOS or Xcode update?
Recheck compatibility and runtime availability. An update may change which components are installed or supported, so a previously selected device may no longer be ready to use. Restart before attempting a reset, and check release notes for information matching the installed Xcode version.
First record where the failure occurs and which Xcode, macOS, and runtime versions are present. If the checks show that your Mac cannot meet the required environment, review the available Mac access options and confirm that the actual setup fits your course before choosing it. If the problem is limited to one project, keep troubleshooting its destination and build errors rather than changing Mac environments.
Frequently asked questions
What should I check first when the Xcode 27 Simulator will not open?
Check the macOS version against Apple’s current Xcode system requirements, then confirm that the iOS Simulator runtime you need is installed in Xcode settings. After that, identify whether the Simulator app fails to open, a device fails to boot, or only your project fails. Reinstalling Xcode before these checks can waste time and may not address the cause.
What can I do if Xcode 27 has no iOS Simulator runtime available?
Open Xcode’s components or platform settings and look for the required iOS runtime. If it is missing, start its download and wait for installation to finish before testing a project. Apple documents additional component downloads separately from installing Xcode itself. If the runtime is not offered, recheck your Xcode version and compatibility rather than deleting project files.
How can I tell whether the Simulator or my iOS project is causing the failure?
First try opening the Simulator and booting an available device without launching your project. If that works, check the project’s selected run destination and deployment target, then note whether the error happens during build, install, or app launch. A build error points toward project configuration or code; a device that never boots points toward the Simulator environment.
What should I try after a macOS or Xcode update breaks Simulator startup?
Confirm that the updated macOS and Xcode versions are supported together, then check whether the required runtime is still installed and available. Restart Xcode and the Mac before attempting a reset. Review the release notes for your exact Xcode version for documented changes or known issues. Avoid deleting devices or runtimes until you know what will be removed.
Further reading
Run Your Xcode Simulator on a Dedicated Mac
Move your course projects to a dedicated physical Mac mini with compute, memory, and storage reserved for you.
