Problems with iOS Build Automation during XCode export

Resolve iOS build automation problems during Xcode export in Unity Build Automation.

Read time 1 minute

Last updated 9 months 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:

Add frameworks via post-process scripts to the XCode project.
Add items to info.plist via post process scripts to the XCode project.
Add other linker flags for missing libraries in third party tools.
Activate iCloud settings.
Add security frameworks.
XCode frameworks.

You can also refer to the following pages:

How to build locally in batchmode.
A support article on how to disable bitcode in a Unity Project.

Documentation

Development

User Acquisition

Monetization

Industry