Esta no es la versión más reciente de la documentación! Click here for the latest released version.

Plataformas y gestión de versiones de Plugins

De versión 4.3.0 en adelante, Córdoba ofrece la posibilidad de guardar y restaurar de plugins y plataformas.

Esta característica permite a los desarrolladores guardar y restaurar la aplicación a un estado conocido sin tener que comprobar en todo el código fuente de plataforma y plugin.

El comando 'save' almacena información sobre la plataforma de aplicación y versiones de plugin en el archivo config.xml. El paso de 'restauración' se produce automáticamente cuando una 'cordova prepare' , haciendo uso de la información previamente guardada en el archivo config.xml.

Un escenario donde guardar/restaurar las capacidades vienen en prácticas es en grandes equipos que trabajan en una aplicación, con cada miembro del equipo centrado en una plataforma o plugin. Esta característica hace más fácil compartir el proyecto y reducir la cantidad de código redundante que se comprueba en el repositorio.

Versiones de la plataforma

Guardando plataformas

Para guardar una plataforma, ejecuta el siguiente comando:

$ cordova platform add <platform[@<version>] | directory | git_url> --save

Después de ejecutar el comando anterior, el archivo config.xml resultante se parece:

<?xml version='1.0' encoding='utf-8'?>
    ...
    <engine name="android" spec="~4.0.0" />
    ...
</xml>

Algunos ejemplos:

'plataforma Córdoba añadir android--guardar' => recupera la versión fijada de la plataforma android, agrega al proyecto y luego actualiza el archivo config.xml.
'plataforma Córdoba añadir android@3.7.0--guardar' => recupera la plataforma android, versión 3.7.0 de MNP, agrega al proyecto y actualizaciones config.xml.
'plataforma Córdoba añadir android @https://github.com/apache/cordova-android.git--guardar' => clones el repositorio especificado git cordova-android, agrega la plataforma android al proyecto, entonces actualiza el archivo config.xml y apunta su versión git-dirección url especificada.
'plataforma Córdoba Añadir C:/ruta/a/android/plataforma, guardar' => recupera la plataforma android en el directorio especificado, lo añade al proyecto, luego actualizaciones config.xml y punto al directorio.

Masa de ahorro plataformas sobre un proyecto existente

El '--guardar ' bandera descrita sólo es útil cuando Recuerdas a utilizar durante la adición de la plataforma. Si tienes un proyecto ya existente y desea guardar todas las plataformas actualmente agregadas en su proyecto, usted puede utilizar:

$ cordova platform save

Actualización / eliminación de plataformas

También es posible actualizar/eliminar del archivo config.xml durante los comandos 'cordova platform update' y 'cordova platform remove':

$ cordova platform update <platform[@<version>] | directory | git_url> --save
$ cordova platform remove <platform> --save

Algunos ejemplos:

'Córdoba plataforma actualización android--guardar' => además de actualizar la plataforma android a la versión anclada, actualización config.xml entrada
'Córdoba plataforma update android@3.8.0--guardar' => además de actualizar la plataforma android a la versión 3.8.0, actualización config.xml entrada
'Córdoba plataforma update /path/to/android/platform--guardar' => además de actualizar la plataforma android a la versión en la carpeta, actualizar archivo config.xml entrada
'plataforma cordova quitar android--guardar' => extrae el proyecto de la plataforma android y elimina su entrada del archivo config.xml.

Restauración de plataformas

Plataformas se restauran automáticamente de config.xml cuando se ejecuta el comando 'cordova preparar' .

Si agrega una plataforma sin especificar una versión/carpeta/git_url, la versión a instalar es tomada de config.xml, si encuentran.

Ejemplo:

Supongamos que el archivo config.xml contiene la entrada siguiente:

<?xml version='1.0' encoding='utf-8'?>
    ...
    <engine name="android" spec="3.7.0" />
    ...
</xml>

Si ejecuta el comando 'plataforma Córdoba añadir android' (no versión/carpeta/git_url especificado), se instalará la plataforma 'android@3.7.0' (como Obtenido de config.xml).

Versión del plugin

(Los comandos de plugin son un espejo de los comandos de plugin)

Guardando plugins

Para guardar un plugin, ejecuta el siguiente comando:

$ cordova plugin add <plugin[@<version>] | directory | git_url> --save

Después de ejecutar el comando anterior, el archivo config.xml resultante se parece:

<?xml version='1.0' encoding='utf-8'?>
    ...
    <plugin name="cordova-plugin-console" spec="~1.0.0" />
    ...
</xml>

Algunos ejemplos:

'cordova plugin add cordova-plugin-consola - ' => recupera la versión del plugin consola anclada, agrega al proyecto y luego actualiza el archivo config.xml.
'Córdoba plugin add cordova-plugin-console@0.2.13--guardar' => recupera el plugin de android, versión 0.2.13 del MNP, agrega al proyecto y actualizaciones config.xml.
'cordova plugin add https://github.com/apache/cordova-plugin-console.git--guardar' => clones el CVS console especificado plugin, agrega el plugin de la consola para el proyecto, entonces actualiza el archivo config.xml y apunta su versión git-dirección url especificada.
'Córdoba plugin Añadir C:/ruta/a/consola/plugin--guardar' => recupera el plugin de la consola en el directorio especificado, agrega el proyecto, luego actualizaciones config.xml y punto al directorio.

Masa de ahorro plugins en un proyecto existente

El '--guardar ' bandera descrita sólo es útil cuando Recuerdas a utilizar durante la adición del plugin. Si tienes un proyecto ya existente y desea guardar todos actualmente había añadido plugins en el proyecto, se puede utilizar:

$ cordova plugin save

Actualizar / eliminar plugins

También es posible actualizar/eliminar del archivo config.xml durante los comandos 'cordova plugin update' y 'quitar plugin de Córdoba':

$ cordova plugin update <plugin[@<version>] | directory | git_url> --save
$ cordova plugin remove <plugin> --save

Algunos ejemplos:

'Córdoba plugin update cordova-plugin-consola - guardar' => además de actualizar el plugin de la consola a la versión anclada, actualización config.xml entrada
'Córdoba plugin update cordova-plugin-console@0.2.13--guardar' => además de actualizar el plugin de android a la versión 3.8.0, actualización config.xml entrada
'Córdoba plugin update /path/to/console/plugin--guardar' => además de actualizar el plugin de la consola a la versión en la carpeta, actualizar archivo config.xml entrada
'plugin cordova cordova-plugin-consola - excepto ' quitar => quita el complemento de consola del proyecto y elimina su entrada del archivo config.xml.

Restauración de plugins

Plugins se restauran automáticamente de config.xml cuando se ejecuta el comando 'cordova preparar' .

Si añades un plugin sin especificar una versión/carpeta/git_url, la versión a instalarse se toma del archivo config.xml, si encuentran.

Ejemplo:

Supongamos que el archivo config.xml contiene la entrada siguiente:

<?xml version='1.0' encoding='utf-8'?>
    ...
    <plugin name="cordova-plugin-console" spec="0.2.11" />
    ...
</ xml>

Si ejecuta el comando 'cordova plugin add cordova-plugin-consola' (no versión/carpeta/git_url especificado), se instalará el plugin 'cordova-plugin-console@0.2.11' (como Obtenido de config.xml).