# PhoneGap Documentation

# 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.9.0 from 2.8.0

1. Run bin/update

## Upgrade to 2.8.0 from 2.7.0

1. Remove cordova-2.7.0.jar from the libs directory in your project
2. Add cordova-2.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.js into your project
5. Update your HTML to use the new cordova.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.7.0 from 2.6.0

1. Remove cordova-2.6.0.jar from the libs directory in your project
2. Add cordova-2.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-2.7.0.js into your project
5. Update your HTML to use the new cordova-2.7.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.6.0 from 2.5.0

1. Remove cordova-2.5.0.jar from the libs directory in your project
2. Add cordova-2.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-2.6.0.js into your project
5. Update your HTML to use the new cordova-2.6.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

. 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