Documentation

Support

Problems with iOS Build Automation during XCode export

Resolve iOS build automation problems during Xcode export in Unity Build Automation.
Read time 1 minuteLast updated 16 hours ago

Symptom

Build errors appear in the Xcode project when you build your iOS project in Unity Build Automation (UBA).

Causes

Most Xcode build failures in UBA are related to third party plug-ins, specifically those that require a minimum version of Xcode or require that you disable bitcode. Build errors can also occur if the post process can't find the Xcode project and can't add the appropriate libraries.

Resolution

Ensure you can build your project locally in the desired version of Xcode with the same settings: don't modify the Xcode project unless you do the same modifications in the post-export script in UBA. If the post process can't find the Xcode project, you need to pass that path to
OnPostProcessBuild
. Some third party plug-ins, or your own code, require a way to modify the XCode project to add libraries or files, which you can use post-process attributes and the Scripting API to do.

Additional resources

There are several Unity Discussions forum posts available, which can help to solve different issues related to iOS projects: You can also refer to the following pages: