license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing,
     software distributed under the License is distributed on an
     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations
     under the License.

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