Swiftpack.co - Package - handsomecode/UnityBuildKit


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.


Stars: 23
Help us keep the lights on


Used By

Total: 0


1.1.4 - Feb 8, 2018

1.1.3 - Feb 7, 2018

1.1.2 - Feb 6, 2018

1.1.1 - Feb 1, 2018

1.1.0 - Jan 31, 2018