cordova-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "ASF GitHub Bot (JIRA)" <>
Subject [jira] [Commented] (CB-8900) Document Platform and Plugin Version Management
Date Wed, 27 May 2015 17:30:17 GMT


ASF GitHub Bot commented on CB-8900:

Github user TimBarham commented on a diff in the pull request:
    --- Diff: docs/en/edge/platform_plugin_versioning_ref/ ---
    @@ -0,0 +1,82 @@
    +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
    +         Unless required by applicable law or agreed to in writing,
    +         software distributed under the License is distributed on an
    +         KIND, either express or implied.  See the License for the
    +         specific language governing permissions and limitations
    +         under the License.
    +# Platforms and Plugins Version Management
    +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.
    +## Platform Versioning
    +### Saving platforms
    +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 :
    +  * **'cordova platform add android --save'** => retrieves the pinned version of the
android platform, adds it to the project and then updates config.xml.
    +  * **'cordova platform add android@3.7.0 --save'** => retrieves the android platform,
version 3.7.0 from npm, adds it to the project and then updates config.xml.
    +  * **'cordova platform add​ --save'**
=> clones the specified cordova-android git repository, adds the android platform to the
project, then updates config.xml and point its version to the specified git-url.
    +  * **'cordova platform add C:/path/to/android/platform --save'** => retrieves the
android platform from the specified directory, adds it to the project, then updates config.xml
and point to the directory.
    +### Mass saving platforms on an existing project
    +The '--save' flag describe above is only useful when you remember to use it during the
platform addition.
    --- End diff --
    Typo: 'describe**d**'

> Document Platform and Plugin Version Management
> -----------------------------------------------
>                 Key: CB-8900
>                 URL:
>             Project: Apache Cordova
>          Issue Type: Task
>          Components: Docs
>            Reporter: Omar Mefire
>            Assignee: Omar Mefire
> This issue is to track work done on documenting the new feature 'platform and plugin
version management'.

This message was sent by Atlassian JIRA

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message