From version 4.3.0 onwards, Cordova provides the ability to save and restore platforms and plugins.
This feature allows developers to save and restore their app to a known state without having to check in all of the platform and plugin source code.
The 'save' command stores details about the app's platform and plugin versions in config.xml. The 'restore' step happens automatically when a 'cordova prepare' is issued, making use of information previously saved in the config.xml file.
One scenario where save/restore capabilities come in handy is in large teams that work on an app, with each team member focusing on a platform or plugin. This feature makes it easier to share the project and reduce the amount of redundant code that is checked in the repository.
To save a platform, you issue the following command :
$ cordova platform add <platform[@<version>] | directory | git_url> --save
After running the above command, the resulting config.xml looks like :
<?xml version='1.0' encoding='utf-8'?> ... <engine name="android" spec="~4.0.0" /> ... </xml>
Some examples :
The '--save' flag described above is only useful when you remember to use it during the platform addition. If you have a pre-existing project and you want to save all the currently added platforms in your project, you can use :
$ cordova platform save
It is also possible to update/delete from config.xml during the commands 'cordova platform update' and 'cordova platform remove' :
$ cordova platform update <platform[@<version>] | directory | git_url> --save $ cordova platform remove <platform> --save
Some examples :
Platforms are automatically restored from config.xml when the 'cordova prepare' command is run.
If you add a platform without specifying a version/folder/git_url, the version to install is taken from config.xml, if found.
Example:
Suppose your config.xml file contains the following entry:
<?xml version='1.0' encoding='utf-8'?> ... <engine name="android" spec="3.7.0" /> ... </xml>
If you run the command 'cordova platform add android' (no version/folder/git_url specified), the platform 'android@3.7.0' (as retrieved from config.xml) will be installed.
(The plugin commands are a mirror of the platform commands)
To save a plugin, you issue the following command :
$ cordova plugin add <plugin[@<version>] | directory | git_url> --save
After running the above command, the resulting config.xml looks like :
<?xml version='1.0' encoding='utf-8'?> ... <plugin name="cordova-plugin-console" spec="~1.0.0" /> ... </xml>
Some examples :
The '--save' flag described above is only useful when you remember to use it during the plugin addition. If you have a pre-existing project and you want to save all currently added plugins in the project, you can use :
$ cordova plugin save
It is also possible to delete from config.xml during the command 'cordova plugin remove' :
$ cordova plugin remove <plugin> --save
For example:
Plugins are automatically restored from config.xml when the 'cordova prepare' command is run.
If you add a plugin without specifying a version/folder/git_url, the version to be installed is taken from config.xml, if found.
Example:
Suppose your config.xml file contains the following entry:
<?xml version='1.0' encoding='utf-8'?> ... <plugin name="cordova-plugin-console" spec="0.2.11" /> ... </ xml>
If you run the command 'cordova plugin add cordova-plugin-console' (no version/folder/git_url specified), the plugin 'cordova-plugin-console@0.2.11' (as retrieved from config.xml) will be installed.
© 2012–2017 The Apache Software Foundation
Licensed under the Apache License 2.0.
https://cordova.apache.org/docs/en/6.x/platform_plugin_versioning_ref/index.html