incubator-callback-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From shaz...@apache.org
Subject docs commit: [CB-1063] Updated the iOS Getting Started Guide
Date Wed, 18 Jul 2012 23:28:56 GMT
Updated Branches:
  refs/heads/master 8f89b497c -> 43330bf53


[CB-1063] Updated the iOS Getting Started Guide


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/43330bf5
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/tree/43330bf5
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/diff/43330bf5

Branch: refs/heads/master
Commit: 43330bf5363fa24054fc430d86dd63fc8e26a1a7
Parents: 8f89b49
Author: Shazron Abdullah <shazron@gmail.com>
Authored: Wed Jul 18 16:28:36 2012 -0700
Committer: Shazron Abdullah <shazron@gmail.com>
Committed: Wed Jul 18 16:28:48 2012 -0700

----------------------------------------------------------------------
 docs/en/edge/guide/getting-started/ios/index.md    |   77 +++++----------
 .../getting-started/ios/bin_create_project.png     |  Bin 0 -> 36904 bytes
 .../img/guide/getting-started/ios/bin_folder.png   |  Bin 0 -> 55499 bytes
 3 files changed, 23 insertions(+), 54 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/43330bf5/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 290068b..db3e0b4 100644
--- a/docs/en/edge/guide/getting-started/ios/index.md
+++ b/docs/en/edge/guide/getting-started/ios/index.md
@@ -22,20 +22,15 @@ Getting Started with iOS
 
 This guide describes how to set up your development environment for Apache Cordova and run
a sample Apache Cordova application.
 
-Video Tutorial
---------------
-
-- [Cordova Installer - Xcode 4 Template](http://www.youtube.com/v/R9zktJUN7AI?autoplay=1)
-
 Requirements
 ------------
 - Xcode 4.x
-- Intel-based computer with Mac OS X Lion (10.7)
+- Intel-based computer with Mac OS X Lion or greater (10.7+)
 - Necessary for installing on device:
     - Apple iOS device (iPhone, iPad, iPod Touch)
     - iOS developer certificate
 
-Install iOS SDK and Apache Cordova
+Install the iOS SDK and Apache Cordova
 ----------------------------------
 
 - Install Xcode from the [Mac App Store](http://itunes.apple.com/us/app/xcode/id497799835?mt=12)
@@ -46,50 +41,23 @@ Install iOS SDK and Apache Cordova
 Setup New Project
 -----------------
 
-- Launch Xcode
-- Select the _File Menu_
-- Select _New_ -> _New Project..._
-- Select _Cordova-based Application_ from the list of templates
-
-    ![](img/guide/getting-started/ios/XCode4-templates.png)
-
-- Select the _Next_ button
-- Fill in the _Product Name_ and _Company Identifier_ for your app
-
-    ![](img/guide/getting-started/ios/xcode4-name_your_app.png)
-
-- **Note:** Do **not** check _Use Automatic Reference Counting_
-- Select the _Next_ button
-- Choose a folder to save your new app
-- Select the _Create_ button
-
-We've now created an Apache Cordova project. Next, we need to associate the
-project with a web directory. We need to do this step because of a limitation
-in Xcode project templates.
-
-- Select the _Run_ button in the top left corner. 
-    - your build should succeed and launch in the iOS Simulator
-    - you should see an error in the iOS Simulator informing you that _www/index.html was
not found_
-    - we can fix this by adding a folder to the project that references `www`
-
-    ![](img/guide/getting-started/ios/index-not-found.png)
-
-- Right-click on the project icon in the _Project Navigator_ (left sidebar) and select _Show
in Finder_
-- Using Finder, you should see a `www` directory inside your project
+- Copy the **bin** folder (either from the source, or from the .dmg) to a location on your
hard drive
 
-    ![](img/guide/getting-started/ios/www-folder.png)
+    ![](img/guide/getting-started/ios/bin_folder.png)
 
-- Drag the `www` directory into Xcode
-    - A common mistake is to drag the `www` directory into your app's directory inside of
Finder
-    - Please follow the red highlighted section of the image below:
+- Launch **Terminal.app**
+- Drag the copied **bin** folder to the **Terminal.app** icon in your Dock, it should launch
a new Terminal window
+- Type in `./create <project_folder_path> <bundle_id> <project_name>` then
press **"Enter"**
 
-    ![](img/guide/getting-started/ios/project.jpg)
+        <project_folder_path> is the path to your new Cordova iOS project (it must
be empty if it exists)
+        <package_name> is the package name, following reverse-domain style convention
+        <project_name> is the project name
+        
+    ![](img/guide/getting-started/ios/bin_create_project.png)
 
-- After dragging `www` into Xcode, you will be prompted with a few options.
-    - Select _Create folder references for any added folders_
-    - Select the _Finish_ button
 
-    ![](img/guide/getting-started/ios/create-folder-reference.png)
+- **Locate** your new project folder that you just created
+- **Launch** the .xcodeproj file in the folder
 
 Hello World
 -----------
@@ -105,25 +73,26 @@ You can also add any associated JavaScript and CSS files there as well.
 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
+- Change the **Target** in the **Scheme** drop-down menu on the toolbar to **"HelloWorld"**
(your project name)
+- 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
 
 Deploy to Device
 ----------------
 
-- Open `YourAppName-Info.plist`, under the _Supporting Files_ group
-- Change _BundleIdentifier_ to the identifier provided by Apple or your own bundle identifier
+- Open `HelloWorld-Info.plist`, 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 run the [Assistant](http://developer.apple.com/iphone/manage/overview/index.action)
to register your app
-- Change the _Active SDK_ in the Scheme drop-down menu on the toolbar to _YourDeviceName_
+- Change the **Active SDK** in the Scheme drop-down menu on the toolbar to **[Your Device
Name]**
     - You will need to have your device connected via USB
-- Select the _Run_ button in your project window's toolbar
+- Select the **Run** button in your project window's toolbar
 
     ![](img/guide/getting-started/ios/HelloWorldiPhone4.png)
 
 Build Your App
 --------------
 
-You now have an Xcode project setup and you can build and run on the simulator and device.
+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.
+You can use your favourite text editor and simply rebuild your project using Xcode, or the
[command-line tools](guide_command-line_index.md.html#Command-Line%20Usage) in your project
folder (under the **cordova** sub-folder)
 Xcode will automatically detect the files that are changed in `www`.

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/43330bf5/template/docs/default/img/guide/getting-started/ios/bin_create_project.png
----------------------------------------------------------------------
diff --git a/template/docs/default/img/guide/getting-started/ios/bin_create_project.png b/template/docs/default/img/guide/getting-started/ios/bin_create_project.png
new file mode 100644
index 0000000..6c75e34
Binary files /dev/null and b/template/docs/default/img/guide/getting-started/ios/bin_create_project.png
differ

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/43330bf5/template/docs/default/img/guide/getting-started/ios/bin_folder.png
----------------------------------------------------------------------
diff --git a/template/docs/default/img/guide/getting-started/ios/bin_folder.png b/template/docs/default/img/guide/getting-started/ios/bin_folder.png
new file mode 100644
index 0000000..3848df7
Binary files /dev/null and b/template/docs/default/img/guide/getting-started/ios/bin_folder.png
differ


Mime
View raw message