Updated Branches: refs/heads/master d358abe19 -> ffbd0ce50
[CB-3558] adds full bb upgrade guides to edge Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/aa5c2735 Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/aa5c2735 Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/aa5c2735 Branch: refs/heads/master Commit: aa5c2735ad65a862c3bb5295d7f3a325cb7696f6 Parents: d358abe Author: lorinbeer <[email protected]> Authored: Mon Jun 3 14:38:02 2013 -0700 Committer: lorinbeer <[email protected]> Committed: Mon Jun 3 15:13:59 2013 -0700 ---------------------------------------------------------------------- docs/en/edge/guide/upgrading/blackberry/index.md | 130 ++++++++++++++++- 1 files changed, 129 insertions(+), 1 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/aa5c2735/docs/en/edge/guide/upgrading/blackberry/index.md ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/upgrading/blackberry/index.md b/docs/en/edge/guide/upgrading/blackberry/index.md index e7853e6..cd713e6 100644 --- a/docs/en/edge/guide/upgrading/blackberry/index.md +++ b/docs/en/edge/guide/upgrading/blackberry/index.md @@ -20,7 +20,135 @@ license: Licensed to the Apache Software Foundation (ASF) under one Upgrading Cordova BlackBerry ============================ -This document is for people who need to upgrade their Cordova versions from an older version to a current version of Cordova. +This document describes the process of upgrading Cordova projects to the latest released version + +## Upgrading Cordova 2.6.0 projects to 2.7.0 ## + +1. **Download and extract the Cordova 2.7.0 source** to a **permanent folder location** on your hard drive (say to ~/Cordova-2.7.0) +2. **Quit any running IDE's** Eclipse, Momentics and the like. +3. **Navigate** to the directory where you put the downloaded source above, using a unix like terminal: **Terminal.app**, **Bash**, **Cygwin**, etc. +4. [**Create a new project**](guide_command-line_index.md.html#Command-Line%20Usage_ios) from the command-line tools - you will have to grab the assets from this new project +5. **Copy** the **www/cordova-2.7.0.js** file from the new project into your **www** folder, and delete your **www/cordova-2.6.0.js** file +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-2.7.0.js** file +7. **Copy** the **native** folder from the new project into the existing project, overwriting the old **native** folder +8. **Copy** the **lib** folder from the new project into the existing project, overwriting the old **lib** folder +9. **Copy** the **cordova** folder from the new project into the existing project, overwriting the old **cordova** folder + +## Upgrade to 2.6.0 from 2.5.0 ## + +Updating the PhoneGap download folder: + +It is recommended that you download a fresh copy of the entire folder. + +However, here are the new parts needed for the piecemeal update: +1. Update the cordova.blackberry.js file in the âPhonegap-2.6.0/lib/blackberry/javascriptâ folder +2. Update the âextâ, âext-airâ, and âext-qnxâ in the âPhonegap-2.6.0/lib/blackberry/frameworkâ folder +3. Update the âbuild.xmlâ file in the âPhonegap-2.6.0/lib/blackberryâ folder +4. Update the the âPhonegap-2.6.0/lib/blackberry/binâ folder +5. Update the âVERSIONâ file in the âPhonegap-2.6.0/lib/blackberryâ folder + +Updating the example/ folder or migrating an existing project: + +1. Open your `www/` folder, which contains your app. +2. Remove and update the .jar file in the `ext/` folder. +3. Update the contents of the `ext-air/` folder. +4. Update the contents of the `ext-qnx/` folder. +4. Copy the new `cordova-2.6.0.js` into your project. +5. Update your HTML to use the new `cordova-2.6.0.js` file. + +## Upgrade to 2.4.0 from 2.3.0 ## + +Updating just the www folder: + +1. Open your `www/` folder, which contains your app. +2. Remove and update the .jar file in the `ext/` folder. +3. Update the contents of the `ext-air/` folder. +4. Copy the new `cordova-2.4.0.js` into your project. + - If playbook, then update the .js file in the `playbook/` folder. + - If BlackBerry10, then update the .js file in the `qnx/` folder. +5. Update your HTML to use the new `cordova-2.4.0.js` file. + + +Updating the sample folder (ie, updating using the ant tools): + +1. Open the `sample/lib/` folder. +2. Update the .jar file in the `cordova.2.3.0/ext/` folder. +3. Update the contents of the `cordova.2.3.0/ext-air/` folder. +4. Update the contents of the `cordova.2.3.0/ext-qnx/` folder. +5. Update the .js file in the `cordova.2.3.0/javascript/` folder. +6. Open the `sample/lib/` folder and rename the `cordova.2.3.0/` folder to `cordova.2.4.0/`. +7. Type `ant blackberry build` or `ant playbook build` to update the `www/` folder with updated Cordova. +8. Open the `www/` folder and update your HTML to use the new `cordova-2.4.0.js` file + +## Upgrade to 2.3.0 from 2.2.0 ## + +Updating just the www folder: + +1. Open your `www/` folder, which contains your app. +2. Remove and update the .jar file in the `ext/` folder. +3. Update the contents of the `ext-air/` folder. +4. Copy the new `cordova-2.3.0.js` into your project. + - If playbook, then update the .js file in the `playbook/` folder. + - If BlackBerry10, then update the .js file in the `qnx/` folder. +5. Update your HTML to use the new `cordova-2.3.0.js` file. + + +Updating the sample folder (ie, updating using the ant tools): + +1. Open the `sample/lib/` folder. +2. Update the .jar file in the `cordova.2.2.0/ext/` folder. +3. Update the contents of the `cordova.2.2.0/ext-air/` folder. +4. Update the contents of the `cordova.2.2.0/ext-qnx/` folder. +5. Update the .js file in the `cordova.2.2.0/javascript/` folder. +6. Open the `sample/lib/` folder and rename the `cordova.2.2.0/` folder to `cordova.2.3.0/`. +7. Type `ant blackberry build` or `ant playbook build` to update the `www/` folder with updated Cordova. +8. Open the `www/` folder and update your HTML to use the new `cordova-2.3.0.js` file + +## Upgrade to 2.2.0 from 2.1.0 ## + +Updating just the www folder: + +1. Open your `www/` folder, which contains your app. +2. Remove and update the .jar file in the `ext/` folder. +3. Update the contents of the `ext-air/` folder. +4. Copy the new `cordova-2.2.0.js` into your project. + - If playbook, then update the .js file in the `playbook/` folder. + - If BlackBerry10, then update the .js file in the `qnx/` folder. +5. Update your HTML to use the new `cordova-2.2.0.js` file. + + +Updating the sample folder (ie, updating using the ant tools): + +1. Open the `sample/lib/` folder. +2. Update the .jar file in the `cordova.2.1.0/ext/` folder. +3. Update the contents of the `cordova.2.1.0/ext-air/` folder. +4. Update the contents of the `cordova.2.1.0/ext-qnx/` folder. +5. Update the .js file in the `cordova.2.1.0/javascript/` folder. +6. Open the `sample/lib/` folder and rename the `cordova.2.1.0/` folder to `cordova.2.2.0/`. +7. Type `ant blackberry build` or `ant playbook build` to update the `www/` folder with updated Cordova. +8. Open the `www/` folder and update your HTML to use the new `cordova-2.2.0.js` file. + +## Upgrade to 2.1.0 from 2.0.0 ## + +Updating just the www folder: + +1. Open your `www/` folder, which contains your app. +2. Remove and update the .jar file in the `ext/` folder. +3. Update the contents of the `ext-air/` folder. +4. Copy the new `cordova-2.1.0.js` into your project. + - If playbook, then update the .js file in the `playbook/` folder. +5. Update your HTML to use the new `cordova-2.1.0.js` file. + + +Updating the sample folder (ie, updating using the ant tools): + +1. Open the `sample/lib/` folder. +2. Update the .jar file in the `cordova.2.0.0/ext/` folder. +3. Update the contents of the `cordova.2.0.0/ext-air/` folder. +4. Update the .js file in the `cordova.2.0.0/javascript/` folder. +5. Open the `sample/lib/` folder and rename the `cordova.2.0.0/` folder to `cordova.2.1.0/`. +6. Type `ant blackberry build` or `ant playbook build` to update the `www/` folder with updated Cordova. +7. Open the `www/` folder and update your HTML to use the new `cordova-2.1.0.js` file. ## Upgrade to 2.0.0 from 1.9.0 ##
