Unity iOS Build Failed in Xcode

How to fix it

Try these in order — the most common fix is first.

1. 1. Fix signing

   Copy steps
   1. Open Unity-iPhone.xcodeproj in Xcode
   2. Select the target, open Signing & Capabilities, choose your Team
   3. Or set Automatically Sign and Apple Developer Team ID in Unity Player Settings > iOS
   Did this fix it? Yes No

2. 2. Fix CocoaPods

   Copy steps
   1. Install or update CocoaPods in Terminal
   2. Run pod install in the build folder
   3. Open the .xcworkspace, not the .xcodeproj, when a Podfile exists
   Did this fix it? Yes No

3. 3. Rebuild clean

   Copy steps
   1. Build to a new empty folder or choose Replace instead of Append
   2. In Xcode choose Product > Clean Build Folder
   Did this fix it? Yes No

4. 4. Match Xcode and Unity versions

   Copy steps
   1. Check the Unity release notes for the Xcode version your Editor supports
   2. Update Unity to a recent patch of your LTS version
   Did this fix it? Yes No

Symptoms

Unity builds an Xcode project but Xcode shows red errors, pod install fails, or signing errors block the build.

Why it happens

• CocoaPods not installed or out of date
• Signing team or provisioning profile not set
• Plugins with conflicting or duplicate native libraries
• Xcode version too old or new for the Unity version
• Using Append over an old Xcode project

This guide also covers

• unity ios build failed
• unity xcode build error
• unity cocoapods error
• unity ios signing error

Other Unity errors

• Unity Hub Not Opening
• Unity License Activation Failed
• Unity Editor Crashing
• Unity Build Failed
• Unity Android Gradle Build Failed
• Unity Package Manager Errors
• Unity Slow Compile and Domain Reload
• Why Is Unity Editor So Slow