Updated February 16, 2024

Just need the steps? Here's how:

  1. Navigate to Xcode > Settings....
  2. Click on the Locations tab in the preferences dialog.
  3. Locate Derived Data and click on the horizontal arrow (it's quite small) to open its location in finder.
  4. Close Xcode, delete the folder via Finder.
  5. Reopen Xcode, rebuild everything.

Original post from 2021

I've recently started working on a pretty fun React Native project. It's been a great learning experience, full of new learnings. One big thing I'm contending with now is unexpected errors in my Xcode build step for iOS.

Today I had a strange one. I had worked on the app for about half an hour yesterday without issue. Closed everything down and came back to it one day later, having made no changes to my environment or code. But Xcode just wouldn't build. I followed a few of the build errors to this post about deleting derived data.

So here's how I fixed my problem:

  1. Navigate to Xcode > Preferences.
  2. Click on the Locations tab in the preferences dialog.
  3. Locate Derived Data and click on the arrow to open its location in finder.
  4. Close Xcode, delete the folder via Finder.
  5. Reopen Xcode, rebuild everything.

Just a nice litle Fonzy-esque reset to add to your troubleshooting toolbelt.