Getting Started with iOS
This guide describes how to set up your development environment for Cordova and run a sample application.
- Intel-based computer with Mac OS X Lion (10.7)
- Necessary for Installing on Device:
- An Apple iOS device (iPhone, iPad, iPod Touch)
- iOS developer certification
2. Install SDK + Cordova
- Install Xcode from the Mac App Store
- Download the latest copy of Cordova and extract its contents. We will be working with the lib/ios directory.
3. Setup New Project
- Launch Xcode
- Select the File menu
- Select New, then New Project...
Select Cordova-based Application from the list of templates
Select the Next button
Fill in the "Product Name" & "Company Identifier" for your app
IMPORTANT! DO NOT CHECK the "Use Automatic Reference Counting" checkbox
Select the Next button
Choose a folder to save your new app in
Select the Create button, this will create your project
Select the Run button in the top left corner. Your build should succeed and launch in the iOS Simulator
a. You should see an error in the iOS Simulator informing you that www/index.html was not found
b. To fix this, we need to add a folder reference to the www directory into the project.
Right-click on the project icon in the Project Navigator (left sidebar) and select Show in Finder
In the Finder, you should see the www directory beside your project
IMPORTANT! Drag the www folder into Xcode 4. Don't drag the www folder into your app's folder. It needs to be dragged into Xcode 4. For example, you would drag and drop it on the highlighted red section of the HelloWorld project shown below.
A window sheet should slide down with a few options, after the "www" folder has been dragged and dropped into the project.
Select the radio-button Create folder references for any added folders.
Select the Finish button
4. Hello World
- Select the folder named www in your Project Navigator in Xcode
- Select the index.html file
<h1>[Hello World](../webos/index.html)</h1>after the
5A. Deploy to Simulator
- Change the Active SDK in the Scheme drop-down menu on the toolbar to iOS version# Simulator.
- Select the Run button in your project window's toolbar
5B. Deploy to Device
- Open [AppName]-Info.plist (where [AppName] is your application's name), under the "Supporting Files" group
- Change BundleIdentifier to the identifier provided by Apple, or your own bundle identifier. If you have a developer license, you can access and run the Assistant here and register your app.
- Change the Active SDK in the Scheme drop-down menu on the toolbar to [DEVICENAME] where [DEVICENAME] is the name of the device you want to deploy to.
Select the Run button in your project window's toolbar