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.

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.0.0 from 1.9.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.0.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.0.0.js file.
  6. Update your www/plugins.xml file. Two plugins changed their namespace/service label. Change the old entries for the Capture and Contact plugins from:

     <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
     <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
    

    To:

     <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
     <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
    

Updating the sample folder (ie, updating using the ant tools):

  1. Open the sample/lib/ folder.
  2. Update the .jar file in the cordova.1.9.0/ext/ folder.
  3. Update the contents of the cordova.1.9.0/ext-air/ folder.
  4. Update the .js file in the cordova.1.9.0/javascript/ folder.
  5. Open the sample/lib/ folder and rename the cordova.1.9.0/ folder to cordova.2.0.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.0.0.js file.
  8. Open the www/ folder and update the plugins.xml file. Two plugins changed their namespace/service label. Change the old entries for the Capture and Contact plugins from:

      <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
      <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
    

    To:

      <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
      <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
    
  • To upgrade to 1.8.0, please go from 1.7.0

Upgrade to 1.8.0 from 1.7.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-1.8.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-1.8.0.js file.
  6. Update your www/plugins.xml file. Two plugins changed their namespace/service label. Change the old entries for the Capture and Contact plugins from:

     <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
     <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
    

    To:

     <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
     <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
    

Updating the sample folder (ie, updating using the ant tools):

  1. Open the sample/lib/ folder.
  2. Update the .jar file in the cordova.1.7.0/ext/ folder.
  3. Update the contents of the cordova.1.7.0/ext-air/ folder.
  4. Update the .js file in the cordova.1.7.0/javascript/ folder.
  5. Open the sample/lib/ folder and rename the cordova.1.7.0/ folder to cordova.1.8.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-1.8.0.js file.
  8. Open the www/ folder and update the plugins.xml file. Two plugins changed their namespace/service label. Change the old entries for the Capture and Contact plugins from:

      <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
      <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
    

    To:

      <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
      <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>