Upgrading Cordova Android

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.8.0 from 2.7.0

  1. Run bin/update with the project path listed in the Cordova Source directory

Upgrade to 2.7.0 from 2.6.0

  1. Run bin/update with the project path listed in the Cordova Source directory

Upgrade to 2.6.0 from 2.5.0

  1. Run bin/update with the project path listed in the Cordova Source directory

Upgrade to 2.5.0 from 2.4.0

  1. Remove cordova-2.4.0.jar from the libs directory in your project
  2. Add cordova-2.5.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new cordova-2.5.0.js into your project
  5. Update your HTML to use the new cordova-2.5.0.js file
  6. Copy the res/xml/config.xml to be the same as the one found in framework/res/xml/config.xml
  7. Update framework/res/xml/config.xml to have similar settings as it did previously
  8. Copy files from bin/templates/cordova to the cordova directory in your project

Upgrade to 2.4.0 from 2.3.0

  1. Remove cordova-2.3.0.jar from the libs directory in your project
  2. Add cordova-2.4.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new cordova-2.4.0.js into your project
  5. Update your HTML to use the new cordova-2.4.0.js file
  6. Copy the res/xml/config.xml to be the same as the one found in framework/res/xml/config.xml
  7. Copy files from bin/templates/cordova to the cordova directory in your project

Upgrade to 2.3.0 from 2.2.0

  1. Remove cordova-2.2.0.jar from the libs directory in your project
  2. Add cordova-2.3.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new cordova-2.3.0.js into your project
  5. Update your HTML to use the new cordova-2.3.0.js file
  6. Copy the res/xml/config.xml to be the same as the one found in framework/res/xml/config.xml
  7. Copy files from bin/templates/cordova to the cordova directory in your project

Upgrade to 2.2.0 from 2.1.0

  1. Remove cordova-2.1.0.jar from the libs directory in your project
  2. Add cordova-2.2.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new cordova-2.2.0.js into your project
  5. Update your HTML to use the new cordova-2.2.0.js file
  6. Copy the res/xml/config.xml to be the same as the one found in framework/res/xml/config.xml
  7. Copy files from bin/templates/cordova to the cordova directory in your project

Upgrade to 2.1.0 from 2.0.0

  1. Remove cordova-2.0.0.jar from the libs directory in your project
  2. Add cordova-2.1.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new cordova-2.1.0.js into your project
  5. Update your HTML to use the new cordova-2.1.0.js file
  6. Copy the res/xml/config.xml to be the same as the one found in framework/res/xml/config.xml
  7. Copy files from bin/templates/cordova to the cordova directory in your project

Upgrade to 2.0.0 from 1.9.0

  1. Remove cordova-1.9.0.jar from the libs directory in your project
  2. Add cordova-2.0.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new cordova-2.0.0.js into your project
  5. Update your HTML to use the new cordova-2.0.0.js file
  6. Copy the res/xml/config.xml to be the same as the one found in framework/res/xml/config.xml

Notes about 2.0.0 release

config.xml will be replacing cordova.xml and plugins.xml. This new file is a combination of the previous two. However, the old files are deprecated, and and while currently still work, will cease working in a future release.

Upgrade to 1.9.0 from 1.8.1

  1. Remove cordova-1.8.0.jar from the libs directory in your project
  2. Add cordova-1.9.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new cordova-1.9.0.js into your project
  5. Update your HTML to use the new cordova-1.9.0.js file
  6. Update the res/xml/plugins.xml to be the same as the one found in framework/res/xml/plugins.xml

Notes about 1.9.0 release

  • Third-Party plugins may or may not work. This is because of the introduction of the CordovaWebView. These plugins need to get a context from the CordovaInterface using getContext() or getActivity(). If you are not an experienced Android developer, please contact the plugin maintainer and add this task to their bug tracker.

Upgrade to 1.8.0 from 1.8.0

  1. Remove cordova-1.8.0.jar from the libs directory in your project
  2. Add cordova-1.8.1.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new cordova-1.8.1.js into your project
  5. Update your HTML to use the new cordova-1.8.1.js file
  6. Update the res/xml/plugins.xml to be the same as the one found in framework/res/xml/plugins.xml

Upgrade to 1.8.0 from 1.7.0

  1. Remove cordova-1.7.0.jar from the libs directory in your project
  2. Add cordova-1.8.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new cordova-1.8.0.js into your project
  5. Update your HTML to use the new cordova-1.8.0.js file
  6. Update the res/xml/plugins.xml to be the same as the one found in framework/res/xml/plugins.xml

Upgrade to 1.8.0 from 1.7.0

  1. Remove cordova-1.7.0.jar from the libs directory in your project
  2. Add cordova-1.8.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new cordova-1.8.0.js into your project
  5. Update your HTML to use the new cordova-1.8.0.js file
  6. Update the res/xml/plugins.xml to be the same as the one found in framework/res/xml/plugins.xml

Upgrade to 1.7.0 from 1.6.1

  1. Remove cordova-1.6.1.jar from the libs directory in your project
  2. Add cordova-1.7.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new cordova-1.7.0.js into your project
  5. Update the res/xml/plugins.xml to be the same as the one found in framework/res/xml/plugins.xml

Upgrade to 1.6.1 from 1.6.0

  1. Remove cordova-1.6.0.jar from the libs directory in your project
  2. Add cordova-1.6.1.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new cordova-1.6.1.js into your project
  5. Update the res/xml/plugins.xml to be the same as the one found in framework/res/xml/plugins.xml

Upgrade to 1.6.0 from 1.5.0

  1. Remove cordova-1.5.0.jar from the libs directory in your project
  2. Add cordova-1.6.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new cordova-1.6.0.js into your project
  5. Update your HTML to use the new cordova-1.6.0.js file
  6. Update the res/xml/plugins.xml so that it is the same as the one found in framework/res/xml/plugins.xml
  7. Replace the res/xml/phonegap.xml with res/xml/cordova.xml so that it is the same as the one found in framework/res/xml/cordova.xml

Upgrade to 1.5.0 from 1.4.0

  1. Remove phonegap-1.4.0.jar from the libs directory in your project
  2. Add cordova-1.5.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new cordova-1.5.0.js into your project
  5. Update your HTML to use the new cordova-1.5.0.js file
  6. Update the res/xml/plugins.xml so that it is the same as the one found in framework/res/xml/plugins.xml
  7. Replace the res/xml/phonegap.xml with res/xml/cordova.xml so that it is the same as the one found in framework/res/xml/cordova.xml

Upgrade to 1.4.0 from 1.3.0

  1. Remove phonegap-1.3.0.jar from the libs directory in your project
  2. Add phonegap-1.4.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new phonegap-1.4.0.js into your project
  5. Update your HTML to use the new phonegap-1.4.0.js file
  6. Update the res/xml/plugins.xml so that it is the same as the one found in framework/res/xml/plugins.xml
  7. Update the res/xml/phonegap.xml so that it is the same as the one found in framework/res/xml/phonegap.xml

Upgrade to 1.3.0 from 1.2.0

  1. Remove phonegap-1.2.0.jar from the libs directory in your project
  2. Add phonegap-1.3.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new phonegap-1.3.0.js into your project
  5. Update your HTML to use the new phonegap-1.2.0.js file
  6. Update the res/xml/plugins.xml so that it is the same as the one found in framework/res/xml/plugins.xml
  7. Update the res/xml/phonegap.xml so that it is the same as the one found in framework/res/xml/phonegap.xml

Upgrade to 1.2.0 from 1.1.0

  1. Remove phonegap-1.1.0.jar from the libs directory in your project
  2. Add phonegap-1.2.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new phonegap-1.2.0.js into your project
  5. Update your HTML to use the new phonegap-1.2.0.js file
  6. Update the res/xml/plugins.xml so that it is the same as the one found in framework/res/xml/plugins.xml
  7. Update the res/xml/phonegap.xml so that it is the same as the one found in framework/res/xml/phonegap.xml

Upgrade to 1.1.0 from 1.0.0

  1. Remove phonegap-1.0.0.jar from the libs directory in your project
  2. Add phonegap-1.1.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new phonegap-1.1.0.js into your project
  5. Update your HTML to use the new phonegap-1.1.0.js file
  6. Update the res/xml/plugins.xml so that it is the same as the one found in framework/res/xml/plugins.xml

Upgrade to 1.0.0 from 0.9.6

  1. Remove phonegap-0.9.6.jar from the libs directory in your project
  2. Add phonegap-1.0.0.jar to the libs directory in your project
  3. If you are using Eclipse, please refresh your eclipse project and do a clean
  4. Copy the new phonegap-1.0.0.js into your project
  5. Update your HTML to use the new phonegap-1.0.0.js file
  6. Add the res/xml/plugins.xml so that it is the same as the one found in framework/res/xml/plugins.xml