Getting Started with iOS

Getting Started with iOS

This guide describes how to set up your development environment for Apache Cordova and run a sample Apache Cordova application.

Requirements

Install the iOS SDK and Apache Cordova

Install CordovaLib

  1. Download the Cordova source
  2. Extract the source to their final permanent location on your hard drive (for example, to ~/Documents/Cordova-2.X.X)
  3. There is no step 3

Create a New Project

Note: Starting with Cordova 2.2, the project will have a copy of CordovaLib within it instead of having a dependency on the copy of CordovaLib from your Cordova installation.

If you would like your project to depend directly on your Cordova installation's version of CordovaLib, you can use: ./create --shared, or change the project reference after creation using: ./update_cordova_subproject path/to/you/project.

Deploy to Simulator

Deploy to Device

Results

Problems in Xcode

If you have compilation problems related to missing headers, the build products should build into the same build directory. You may need to set the preference "Xcode Preferences -> Locations -> Derived Data -> Advanced…" to "Unique". This is the default setting for Xcode on a fresh new install, if you upgraded from older versions of Xcode, you might have a legacy preference in there that you need to update.

Build Your App

You now have an Xcode project setup and you can build and run on the Simulator and device. It is important to understand that you do not need to use Xcode to write your web application. You can use your favourite text editor and simply rebuild your project using Xcode, or the command-line tools in your project folder (under the cordova sub-folder) Xcode will automatically detect the files that are changed in www.

Problems in the Command Line Tools

If you see this error: "Error: No developer directory found at /Developer. Run /usr/bin/xcode-select to update the developer directory path." Run this to set your Developer folder:

    sudo /usr/bin/xcode-select -switch /Applications/Xcode.app/Contents/Developer