Building iOS from source

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 the .xcworkspace workspace file in Xcode open <yourapp>.xcworkspace

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


Open .xcworkspace not .xcodeproj

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


All "pods" required by GoNative should be automatically installed by our online build platform. If you need to install additional pods not supplied by GoNative please contact us for assistance and our team will assist.


Missing Files

If you are receive errors about missing files, you should clean your build folder/derived data: