Version: 2018.4
Inside the iOS build process
iOS build settings

Structure of a Unity XCode Project

When you build a project for the iOSApple’s mobile operating system. More info
See in Glossary
platform, Unity will create a folder that contains an XCode project. This project is required to compile and sign your app before deploying on devices, and it allows you to prepare and bundle your game for distribution on the App Store.

Before building the iOS project make sure that you set the Bundle Identifier in Player SettingsSettings that let you set various player-specific options for the final game built by Unity. More info
See in Glossary
. You may also choose the SDK version to run the game on the device or simulator.

Classes folder

This contains code that integrates the Unity Runtime and Objective-C. The contained files main.mm and UnityAppController.mm/h are the entry point of the application, and you can create your own AppDelegate, derived from UnityAppController. If you have plugins including AppController.h you can simply include UnityAppController.h instead. If you have AppController.mm/h in Plugins/iOS folders you can merge and rename them.

Also the InternalProfiler.h file defines a compiler conditional to enable the Internal ProfilerA window that helps you to optimize your game. It shows how much time is spent in the various areas of your game. For example, it can report the percentage of time spent rendering, animating or in your game logic. More info
See in Glossary
. This is a folder for code that doesn’t change often, and you can place your custom classes here. The changes to this folder are preserved between builds when the append mode is selected, but this function doesn’t support multiple build targets and requires a fixed structure of the Libraries folder.

The Internal Profiler is fast and unobtrusive, and feeds basic information:

  • which subsystem is taking most of the frame time,
  • .NET heap size,
  • GC event count/duration. See built-in profiler for further information.

Data folder

This contains the serialized game assetsAny media or data that can be used in your game or Project. An asset may come from a file created outside of Unity, such as a 3D model, an audio file or an image. You can also create some asset types in Unity, such as an Animator Controller, an Audio Mixer or a Render Texture. More info
See in Glossary
, and .NET assemblies (dll or dat files) as full code (or metadata if stripping is on). The machine.config file is the setup for various .NET services such as security, WebRequest, and more. The content of this folder is refreshed with each build, and you should not modify it.

Libraries folder

This contains the .NET assemblies translated into ARM assembler (s files) or libil2cpp.a if the project was built using IL2CPPA Unity-developed scripting back-end which you can use as an alternative to Mono when building Projects for some platforms. More info
See in Glossary
. The libiPhone-lib.a file is the Unity Runtime static library, and RegisterMonoModules.cpp binds Unity native code with .NET. The content of this folder is refreshed with each build, and you should not modify it.

Other newly created custom folders

Your custom files can be placed here.

Graphic files

Icons and splash screens (png files) are kept in asset catalogs found in the Unity-iPhone folder. These files are automatically managed by Unity. Launch Screens, their XML Interface Builders (xib files) and Storyboard files are stored in the project’s root folder. You can set them up in Player Settings. When creating custom launch images, make sure you adhere to Apple’s Human Interface Guidelines.

Property List file

The Info.plist is managed via Player Settings in Unity. This file is updated when building the player, instead of being replaced. You should not modify it unless it is really needed.

Other files

These include the XCode Project file (xcodeproj file), and framework links that are only shown in the Project Navigator.


  • 2018–06–14 Page amended
Inside the iOS build process
iOS build settings