Swift Package Index

A command line tool that generates an iOS application with an embedded Unity scene

  • The latest stable release is 1.1.4. Released 2 years ago.
  • The last commit to master was over 1 year ago.

Swift Version Compatibility

  • 1.1.4 and master
Full build results

Platform Compatibility

  • 1.1.4 and master
Full build results

Note: Further work on UnityBuildKit has been discontinued due to the fact that Unity has created their own functionality for embedding Unity within iOS and Android projects in Unity 2019.3.


UnityBuildKit is a command line tool that embeds a Unity project into an iOS application. Both the Xcode and Unity project are automatically created, configured, and linked for immediate use after successful generation.


UnityBuildKit requires Xcode 9, Swift 4, and Unity


brew tap handsomecode/UnityBuiltKit https://github.com/handsomecode/UnityBuildKit.git
brew install UnityBuildKit


git clone https://github.com/handsomecode/UnityBuildKit
cd UnityBuildKit

Swift Package Manager

Use as a dependency

.package(url: "https://github.com/handsomecode/UnityBuildKit", from: "1.0.0"),


To generate new iOS and Unity projects

Currently, Unity needs to be closed for this process to begin.

  1. Create a top-level folder and navigate to it. This folder will contain all information about the Xcode and Unity projects. (Note: By default, the name of this folder will be the name of the Xcode and Unity projects.)
mkdir ExampleProject
cd ExampleProject
  1. Run the following to generate the ubconfig.json file where you can specify project information (see more information here)
UnityBuildKit config
  1. After filling out the config file, run
$ UnityBuildKit generate


  • The generation script sets up the Unity project to build for the Device SDK. These means that, if building for a simulator, there is a high probability that you will encounter build and linker errors in Xcode. Change the run destination to a physical device and the errors should go away. You can change this in Unity using the Build Settings once generation is completed.

Refreshing the projects

The built Unity files are under ios_build/. When building your Unity project, make sure that you append the new build to this ios_build/ folder so that refresh script knows where the Unity files are located.

The iOS project is automatically updated and refreshed every time the Unity project is built. You shouldn't need to do anything! 😀

Known Unity Version Compatibility

  • 2107.2.0.f3
  • 2017.2.1.f1


This tool is built using:

and the wonderful dependencies they bring with them.

Inspiration for building UnityBuildKit came after running into several problems while trying to manually do this process and reading over a github issue trying to resolve those problems (big thanks to jiulongw).


UnityBuildKit is licensed under the MIT license. See LICENSE for more info.