[CB-4776] Add `cordova platform update` command

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Component/s: cordova-cli
• Assignee: Lorin Beer
• Reporter: Andrew Grieve
• Created: 10/Sep/13 19:34
• Updated: 23/Aug/18 07:27
• Resolved: 23/Oct/13 18:44

Description

Example workflow:

$ cd MyProject
$ cordova --version
3.0.9
$ npm update -g cordova
$ cordova --version
3.1.0-1.0.0
$ cordova platform ls
Installed platforms: 
 android 3.0.0
 ios 3.0.0
Available platforms:
 android 3.1.0
 ios 3.1.0
 blackberry10 3.1.0
$ cordova platform add android
Platform android already exists. Use `update` to upgrade it.
$ cordova platform update android
Updated android from 3.0.0 to 3.1.0
$ cordova platform ls
Installed platforms: 
 android 3.1.0
 ios 3.0.0
Available platforms:
 ios 3.1.0
 blackberry10 3.1.0

How does `cordova platform update` work?

• It uses platforms/*/cordova/version script to discover current version
• It fetches the new version into $HOME/.cordova/libs
• It runs new_version/bin/upgrade path/to/platforms/$PLATFORM for the specified platform

The platform script is responsible for:
#1 - doing all easily automated steps (e.g. update Cordova.jar, update scripts within cordova/)
#2 - Printing out a message saying what manual steps should be taken to complete the upgrade (e.g. Please add this snippet to your ApplicationDelegate)

Issue Links

• is depended upon by: CB-4830 [Release + 3.1.0] Parent Issue
• is duplicated by: CB-2448 Cordova Scripts need to be upgradable without creating a new project.