Help center › Mobile app development

Build a Unity game for iOS

Install Unity with iOS support on your Mac, generate the Xcode project, then build it in Xcode.

Unity builds for iOS in two steps: Unity generates an Xcode project, then Xcode builds the app. Unity’s documentation notes local iOS builds need macOS, because Xcode only runs on a Mac. That’s your RunMac.

  1. Install Xcode first: Install Xcode and simulators.
  2. On the desktop (Screen Sharing), install Unity Hub from unity.com/download, then the Unity Editor version your project uses.
  3. Get your project onto the Mac (git clone) and open it in Unity.
  4. Choose File → Build Profiles, then Add Build Profile, select iOS (if it isn’t available, choose Install with Unity Hub), Add Build Profile, then Switch Profile.
  5. Choose Build and pick a folder. Unity writes the Xcode project there.
  6. Open the generated project in Xcode, set your team under Signing & Capabilities, and run it in the simulator or archive and upload it.

These menu names are from Unity 6. Older Unity versions use File → Build Settings.

Related

Install Xcode and simulatorsSign in with your own Apple Account, install Xcode, accept the licence, add simulators.Set up your Mac for iOS developmentThe order to do things in: connect, Xcode, your Apple Account, GitHub, then your first build.Build and test from the command linexcodebuild and the simulator over SSH: list schemes, pick a simulator, build and run tests.

Still stuck?

Signed-in customers can message us from the portal; we reply within 24 hours on business days (AEST).

Message supportEmail us