You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by sh...@apache.org on 2012/04/06 09:57:54 UTC
docs commit: Fixed CB-455 - Update iOS Getting Started Guide with
updated images, text
Updated Branches:
refs/heads/master 368c93652 -> a4166cb86
Fixed CB-455 - Update iOS Getting Started Guide with updated images, text
Project: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/commit/a4166cb8
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/tree/a4166cb8
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/diff/a4166cb8
Branch: refs/heads/master
Commit: a4166cb862a2cfd92f50717cfcdd831219a744a1
Parents: 368c936
Author: Shazron Abdullah <sh...@gmail.com>
Authored: Fri Apr 6 00:56:32 2012 -0700
Committer: Shazron Abdullah <sh...@gmail.com>
Committed: Fri Apr 6 00:56:32 2012 -0700
----------------------------------------------------------------------
docs/en/edge/guide/getting-started/ios/index.md | 69 ++++++++++-----
.../getting-started/ios/HelloWorldiPhone4.png | Bin 101624 -> 120055 bytes
.../guide/getting-started/ios/XCode4-templates.png | Bin 207971 -> 169771 bytes
.../ios/create-folder-reference.png | Bin 0 -> 172173 bytes
.../guide/getting-started/ios/index-not-found.png | Bin 0 -> 95265 bytes
.../img/guide/getting-started/ios/project.jpg | Bin 39552 -> 43884 bytes
.../img/guide/getting-started/ios/www-folder.png | Bin 0 -> 17844 bytes
.../getting-started/ios/xcode4-name_your_app.png | Bin 186383 -> 163603 bytes
8 files changed, 46 insertions(+), 23 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/a4166cb8/docs/en/edge/guide/getting-started/ios/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/getting-started/ios/index.md b/docs/en/edge/guide/getting-started/ios/index.md
index a1eb4d2..53e37b4 100644
--- a/docs/en/edge/guide/getting-started/ios/index.md
+++ b/docs/en/edge/guide/getting-started/ios/index.md
@@ -1,8 +1,7 @@
Getting Started with iOS
========================
-This guide describes how to set up your development environment for Cordova and run a sample application. Note that Cordova used to be called PhoneGap, so some of the sites still use the old PhoneGap name.
-
+This guide describes how to set up your development environment for Cordova and run a sample application.
Video Tutorials:
----------------
@@ -12,60 +11,85 @@ Video Tutorials:
1. Requirements
---------------
-- Intel-based computer with Mac OS X Snow Leopard (10.6)
+- 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
+ - iOS ceveloper certification
2. Install SDK + Cordova
------------------------
-- Download and install Xcode from [Apple Developer Portal](http://developer.apple.com) (Membership required)</p>
-- Donwload the latest copy of [Cordova](http://phonegap.com/download) and extract its contents. We will be working with the Android directory.
+- Install Xcode from the [Mac App Store](http://itunes.apple.com/us/app/xcode/id497799835?mt=12) </p>
+- Donwload the latest copy of [Cordova](http://phonegap.com/download) and extract its contents. We will be working with the **lib/ios** directory.
3. Setup New Project
--------------------
-- Launch Xcode, then under the File menu select **New** and then **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
+- Select the **Next** button
+- Fill in the "Product Name" & "Company Identifier" for your app
-- Choose a directory to store your app
-- You should see your project in Xcode 4 now. Press the **Run** button in the top left corner. Your build should succeed and launch in the simulator
-- You should see a error in your simulator informing you index.html was not found
-- To fix this, we need to copy the **www** directory into the project. Right click on the project in the left navigation window and click show in finder
-- In Finder, you should see the **www** directory beside your project
-- Next step is **IMPORTANT**! Drag the **www** folder into Xcode 4. You can't just drag the www folder into your app's folder. It needs to be dragged into Xcode 4!! In my case I would drag it and drop it on HiWorld shown below.
+- 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.
-- After you drag, you should see a prompt with a few options. Make sure to select **Create folder references for any added folders**. Click Finish
+- 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
--------------
-Open the folder named **www** and type `<h1>Hello World</h1>` after the `<body>` tag in **index.html**. You can also add any associated Javascript and CSS files there as well.
+- Select the folder named **www** in your Project Navigator in Xcode
+- Select the **index.html** file
+- Type `<h1>Hello World</h1>` after the `<body>` tag
+
+You can also add any associated JavaScript and CSS files there as well.
5A. Deploy to Simulator
-----------------------
-- Make sure to change the Active SDK in the top left menu to **Simulator+version#**.
-- Hit **Run** in your project window header.
+- 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 and change **BundleIdentifier** to the identifier provided by Apple. If you have a developer license, you can access and run the Assistant at [here](http://developer.apple.com/iphone/manage/overview/index.action) and register your App.
-- Make sure to change the Active SDK in the top left menu to **Device+version#**.
-- Hit **Run** in your project window header.
+- Open [AppName]-Info.plist (where [AppName] is your application's name)
+- 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](http://developer.apple.com/iphone/manage/overview/index.action) 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
@@ -73,5 +97,4 @@ Open the folder named **www** and type `<h1>Hello World</h1>` after the `<body>`
Done!
-----
-You can also checkout more detailed version of this guide [here](http://wiki.phonegap.com/w/page/39991939/Getting-Started-with-PhoneGap-iOS-using-Xcode-4-%28Template-Version%29).
-
+Add more HTML, CSS and JavaScript to your **www** folder outside of Xcode, your file additions will be picked up automatically inside Xcode.
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/a4166cb8/template/docs/default/img/guide/getting-started/ios/HelloWorldiPhone4.png
----------------------------------------------------------------------
diff --git a/template/docs/default/img/guide/getting-started/ios/HelloWorldiPhone4.png b/template/docs/default/img/guide/getting-started/ios/HelloWorldiPhone4.png
index 25c22d8..e2aa147 100644
Binary files a/template/docs/default/img/guide/getting-started/ios/HelloWorldiPhone4.png and b/template/docs/default/img/guide/getting-started/ios/HelloWorldiPhone4.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/a4166cb8/template/docs/default/img/guide/getting-started/ios/XCode4-templates.png
----------------------------------------------------------------------
diff --git a/template/docs/default/img/guide/getting-started/ios/XCode4-templates.png b/template/docs/default/img/guide/getting-started/ios/XCode4-templates.png
index 33b0fa9..e3eee61 100644
Binary files a/template/docs/default/img/guide/getting-started/ios/XCode4-templates.png and b/template/docs/default/img/guide/getting-started/ios/XCode4-templates.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/a4166cb8/template/docs/default/img/guide/getting-started/ios/create-folder-reference.png
----------------------------------------------------------------------
diff --git a/template/docs/default/img/guide/getting-started/ios/create-folder-reference.png b/template/docs/default/img/guide/getting-started/ios/create-folder-reference.png
new file mode 100644
index 0000000..45d44be
Binary files /dev/null and b/template/docs/default/img/guide/getting-started/ios/create-folder-reference.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/a4166cb8/template/docs/default/img/guide/getting-started/ios/index-not-found.png
----------------------------------------------------------------------
diff --git a/template/docs/default/img/guide/getting-started/ios/index-not-found.png b/template/docs/default/img/guide/getting-started/ios/index-not-found.png
new file mode 100644
index 0000000..3ed84d3
Binary files /dev/null and b/template/docs/default/img/guide/getting-started/ios/index-not-found.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/a4166cb8/template/docs/default/img/guide/getting-started/ios/project.jpg
----------------------------------------------------------------------
diff --git a/template/docs/default/img/guide/getting-started/ios/project.jpg b/template/docs/default/img/guide/getting-started/ios/project.jpg
index 3fe062e..6e74ca2 100644
Binary files a/template/docs/default/img/guide/getting-started/ios/project.jpg and b/template/docs/default/img/guide/getting-started/ios/project.jpg differ
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/a4166cb8/template/docs/default/img/guide/getting-started/ios/www-folder.png
----------------------------------------------------------------------
diff --git a/template/docs/default/img/guide/getting-started/ios/www-folder.png b/template/docs/default/img/guide/getting-started/ios/www-folder.png
new file mode 100644
index 0000000..8abcdd8
Binary files /dev/null and b/template/docs/default/img/guide/getting-started/ios/www-folder.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/a4166cb8/template/docs/default/img/guide/getting-started/ios/xcode4-name_your_app.png
----------------------------------------------------------------------
diff --git a/template/docs/default/img/guide/getting-started/ios/xcode4-name_your_app.png b/template/docs/default/img/guide/getting-started/ios/xcode4-name_your_app.png
index 4d5bad3..f168e92 100644
Binary files a/template/docs/default/img/guide/getting-started/ios/xcode4-name_your_app.png and b/template/docs/default/img/guide/getting-started/ios/xcode4-name_your_app.png differ