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 2013/07/18 03:48:28 UTC

docs commit: [CB-4222] (Updated) - Update Upgrading Guide for 2.9.0 -> 3.0.0 for iOS

Updated Branches:
  refs/heads/master 847dd84b5 -> fdca73d45


[CB-4222] (Updated) - Update Upgrading Guide for 2.9.0 -> 3.0.0 for iOS


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/fdca73d4
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/fdca73d4
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/fdca73d4

Branch: refs/heads/master
Commit: fdca73d45194c7587eadadb0ab9fe00b2ead3f7d
Parents: 847dd84
Author: Shazron Abdullah <sh...@apache.org>
Authored: Wed Jul 17 18:48:20 2013 -0700
Committer: Shazron Abdullah <sh...@apache.org>
Committed: Wed Jul 17 18:48:20 2013 -0700

----------------------------------------------------------------------
 docs/en/edge/guide/platforms/ios/upgrading.md | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/fdca73d4/docs/en/edge/guide/platforms/ios/upgrading.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/upgrading.md b/docs/en/edge/guide/platforms/ios/upgrading.md
index 4647e3d..3b48536 100644
--- a/docs/en/edge/guide/platforms/ios/upgrading.md
+++ b/docs/en/edge/guide/platforms/ios/upgrading.md
@@ -28,6 +28,25 @@ version of the CLI.
 
 Please note that **Xcode 4.5 is required**. To submit to the Apple App Store, you must use the latest shipped version of the iOS SDK, which is iOS 6. The iOS 6 SDK requires Xcode 4.5.
 
+## Upgrade to the CLI (3.0.0) from 2.9.0 ##
+
+1. Create a new Apache Cordova 3.0.0 project using the cordova CLI, as
+   described in The Cordova Command-line Interface.
+2. Add your platforms the the cordova project, for example: `cordova
+   platform add ios`.
+3. Copy the contents of the project's `www` folder to the `www` folder
+   at the root of the cordova project you just created.
+4. Copy or overwrite any native assets from your original project
+   (`Resources`, etc.), making sure to add any
+   new files to the `.xcodeproj` project. The iOS project builds
+   inside the `platforms\ios` directory.
+5. Copy your config.xml into the www folder, and remove any plugin definitions. You will modify settings here instead of the platform folder.
+6. Use the cordova CLI tool to install any plugins you need. Note that
+   the CLI handles all core APIs as plugins, so they may need to be
+   added. Only 3.0.0 plugins are compatible with the CLI.
+7. Build and test.
+
+
 ## Upgrading 2.9.0 projects to 3.0.0 ##
 
 1. **Download and extract the Cordova 3.0.0 source** to a **permanent folder location** on your hard drive (say to ~/Documents/Cordova-3.0.0)
@@ -38,7 +57,7 @@ Please note that **Xcode 4.5 is required**. To submit to the Apple App Store, yo
 6. **Update** the Cordova script reference in your **www/index.html** file (and any other files that contain the script reference) to point to the new **cordova.js** file
 7. Delete your **"CordovaLib"** folder, and copy the **"CordovaLib"** folder from the new project into your project's root folder
 
-NOTE: Starting with Cordova 3.0.0, projects do not come with any plugins, you will have to install the ones you require for your project using the `plugman` CLI utility - see the Core Plugin Install Guide.
+NOTE: Starting with Cordova 3.0.0, projects do not come with any plugins, you will have to install the ones you require for your project using the `plugman` CLI utility - see the "Using Plugman to Manage Plugins".
 
 
 ## Upgrading 2.8.0 projects to 2.9.0 ##