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.

🚧

Open .xcworkspace not .xcodeproj

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

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

Cocoapods

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: https://stackoverflow.com/questions/38016143/how-can-i-delete-derived-data-in-xcode-8