Structure of an Unity XCode Project

When you build a project for the iOS 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 preparing and bundling your game for distribution on the App Store.

Before building the iOS project make sure that you set the Bundle Identifier in Player Settings. 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 AppController.mm are the entry point of the application. Also the iPhone_Profiler.h file defines a compiler conditional to enable the Internal Profiler. 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 unintrusive, 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 assets, and .NET assemblies (dll 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). 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

These are icons and splash screens (png files). These files are automatically managed by Unity. You can setup them in Player Settings.

Property List file

The info.plist is managed via Player Settings in Unity. With Unity 4.1 this file is updated, 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.

Page last updated: 2013-03-08