Documentation

​
​

Development

User Acquisition

Monetization

Industry

Build Automation

DevOps

Build Automation REST API

Build Automation Editor Package

Open Unity Dashboard

Build Automation

​
​
Build Automation
  • Overview
  • Get started with Build Automation
  • Build Automation Glossary
  • Build configuration
    • Configure a build
    • Use groups to organize build configurations
    • Set up an iOS build configuration
  • Advanced build configuration
  • Run builds
  • Build results
  • Optimize build speed
  • Manage artifact retention rules
  • Manage concurrent builds
  • Sign build artifacts
  • Build Automation integrations
  • Build Automation API
  • Build Automation Editor Package
  • Reference
  1. Unity Build Automation
  3. Build configuration

Set up an iOS build configuration

Set up an iOS build configuration for your Unity project.
Read time 2 minutes
Last updated 6 months ago
Build Automation helps you automate the process of building your Unity Project for iOS devices. There are a number of prequisites for iOS development. Note that Apple processes and requirements do change over time, so it's best to refer to the Apple developer website should you encounter issues.

A note on the Apple Privacy Manifest

Apple is introducing a privacy policy for including privacy manifest files in new and updated applications targeted for iOS, iPadOS, tvOS, and visionOS platforms on the App Store.
The privacy manifest file 
PrivacyInfo.xcprivacy
lists the types of data your Unity applications collect (or any third-party SDKs, packages, and plug-ins), and the reasons for using certain Required Reason API categories. Apple also requires that certain domains be declared as "tracking" and they may be blocked unless a user provides consent.
Warning
If the use of the Required Reasons APIs by you or third-party SDKs isn’t declared in the privacy manifest, your application might be rejected by the App Store. For more information, visit Apple’s documentation on Required Reasons APIs.
Unity Build Automation does not collect data or engage in any data practices requiring disclosure in a privacy manifest file.

Xcode frameworks

If your iOS Project requires additional Xcode frameworks, use the PBXProject API to add those frameworks to the Xcode Project files created by Unity Build Automation.
For an example of a Unity Project that uses the API, see the UpdateXcodeProject example Project on GitHub. You can use the example to experiment and to learn from.
One of the plugins of the example Project is an external Xcode project manipulation DLL. The DLL is the build product of the source available in Unity’s Bitbucket repository. A preferred way to include Xcode project manipulation functionality is to copy the C# source code files to the Assets/Editor folder in your Project.
There are two ways to call this API to manipulate the Xcode project:
  • Use the built-in Unity PostProcessBuildAttribute, which is executed before the Unity Build Automation Post-Export method runs.
  • Use the Unity Build Automation post-export method (requires access to advanced settings).
Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page

    • A note on the Apple Privacy Manifest

    • Xcode frameworks

Report a problem with this page