📖 View this page in our documentation

You must first set up your local iOS development environment. This involves installing Xcode on a computer running Mac OSX.

Please use the latest non-beta version of Xcode.

Building in Xcode

Once Xcode is installed and configured please follow the steps below.

  1. Download the source code wget https://path-from-your-app-management-page/ios_source.tar.gz
  2. Untar with tar -xzvf ios_source.tar.gz
  3. Open the /ios directory cd ios
  4. Open GoNativeIOS.xcworkspace in Xcode open GoNativeIOS.xcworkspace

You may then compile, debug, and upload your iOS app directly using Xcode.


GoNative uses Cocoapods (or "pods") as a dependency package manager, and therefore you must open the workspace file GoNativeIOS.xcworkspace and not the GoNativeIOS.xcodeproj file.

Building through the command line

You may also build the source code via xcodebuild, the command line tool provided with Xcode. Because your app is configured as a workspace, you are required to specify the scheme. To see the list of schemes in the workspace you may run xcodebuild -list in the /ios directory.

To build your app for a physical device:

xcodebuild -workspace GoNativeIOS.xcworkspace/ -scheme GonativeIO -sdk iphoneos

To build your app for the iOS simulator:

xcodebuild -workspace GoNativeIOS.xcworkspace/ -scheme GonativeIO -sdk iphonesimulator


All the "pods" required by GoNative should be automatically installed. If you need to make any changes to your Podfile (which lists the pods the app uses), you may need to run:

pod repo update
pod install

If you do not have Cocoapods installed on your computer yet, you may install it from here: https://cocoapods.org/

Missing Files

If you are receive errors about missing files, you should clean your build folder/derived data: https://stackoverflow.com/questions/38016143/how-can-i-delete-derived-data-in-xcode-8