Documente Academic
Documente Profesional
Documente Cultură
Tabla de Contenidos
docs/tree/master/www/docs/en/dev/guide/cli/index.md)
Pre-requisitos
Antes de ejecutar cualquiera de las herramientas de lnea de comandos, necesita instalar el SDK para cada plataforma.
(Vea las guas de la plataforma para ms detalles)
Para aadir soporte o reconstruir un proyecto para cualquier plataforma, necesitar ejecutar la interfaz de lnea de
comandos desde la misma mquina que soporta el SDK de la plataforma. La CLI admite las siguientes combinaciones:
iOS (Mac)
Amazon Fire OS (Mac, Linux, Windows)
Android (Mac, Linux, Windows)
BlackBerry 10 (Mac, Linux, Windows)
Windows Phone 8 (Windows)
Windows (Windows)
Firefox OS (Mac, Linux, Windows)
En el Mac, es disponible a travs de la aplicacin de la Terminal de la lnea de comandos. En el PC, est disponible como
Command Prompt bajo Accessories.
Nota: para las plataformas Windows, todava puedes desarrollar en equipos Mac ejecutando Windows en una mquina
virtual o en modo de arranque dual. Para las opciones disponibles, consulte la gua de la plataforma de Windows Phone 8
o la gua de la plataforma Windows.
Lo ms probable es que ejecute la CLI de diferentes mquinas, ms tiene sentido mantener un repositorio de cdigo
fuente remota, cuyos activos tire hacia abajo para directorios de trabajo local.
1. Descargue e instale Node.js (http://nodejs.org/). Despus de la instalacin, usted debe ser capaz de ejecutar node y
npm en la lnea de comandos. Si lo desea, opcionalmente puede utilizar una herramienta como nvm o nave para
manejar la instalacin de Node.js.
2. Descarga e instala un cliente de git (http://git-scm.com/), si ya no tienes uno. Despus de la instalacin, usted debe
ser capaz de ejecutar a git en la lnea de comandos. Aunque no utilices git manualmente, la CLI usa de fondo
para descargar algunos archivos cuando se crea un nuevo proyecto.
https://cordova.apache.org/docs/es/latest/guide/cli/ 1/11
12/1/2017 LainterfazdelineadecomandosApacheCordova
3. Instale el mdulo cordova utilizando el manejador de paquetes de Node.js npm . El mdulo cordova sera
descargado automticamente por npm .
en OS X y Linux:
$sudonpminstallgcordova
En OS X y Linux, pre jando la npm mando con sudo puede ser necesario instalar este desarrollo utilidad en otro
modo restringido directorios tales como /usr/local/share . Si usted est utilizando la herramienta opcional
nvm/nave o tener acceso de escritura al directorio de instalacin, podr omitir el sudo pre jo. Hay ms consejos
(http://justjs.com/posts/npm-link-developing-your-own-npm-modules-without-tears) sobre el uso de npm sin
sudo , si desea hacerlo.
en Windows:
C:\>npminstallgcordova
El g bandera arriba dice npm instalar cordova en todo el mundo. De lo contrario ser instalado en el node_modules
subdirectorio del directorio de trabajo actual.
Puede que necesites aadir el npm Directorio a su PATH para invocar a nivel mundial instalada npm mdulos. En
Windows, npm generalmente se puede encontrar en C:\Users\username\AppData\Roaming\npm . En OS X y Linux se
puede encontrar generalmente en /usr/local/share/npm .
El registro de instalacin puede producir errores para cualquier plataforma desinstalado SDK.
Despus de la instalacin, usted debe ser capaz de ejecutar cordova en la lnea de comandos sin argumentos y
debe imprimir el texto de ayuda.
Crear la aplicacin
Vaya al directorio donde mantener su cdigo fuente y ejecutar un comando como el siguiente:
$cordovacreatehellocom.example.helloHelloWorld
Puede tomar algn tiempo para que el comando completar, as que tenga paciencia. Ejecutar el comando con el d
opcin muestra informacin acerca de su progreso.
El primer argumento Hola especi ca un directorio que se generen para su proyecto. Este directorio ya no debera existir,
Crdoba lo crear para usted. Pgina de inicio de su aplicacin, junto con diversos recursos bajo css , js y img , que
seguir comn web convenciones de nomenclatura de archivos de desarrollo las casas su subdirectorio www . Estos activos
se almacenarn en el sistema de archivos local del dispositivo, no sirve de forma remota. El archivo config.xml contiene
metadatos importantes necesarios para generar y distribuir la aplicacin.
El segundo argumento com.example.hello proporciona un identi cador de dominio reverso-estilo su proyecto. Este
argumento es opcional, pero slo si tambin omite el tercer argumento, puesto que los argumentos son posicionales.
Puede editar este valor ms adelante en el config.xml de archivos, pero tenga en cuenta que puede haber cdigo
generado fuera de config.xml utilizando este valor, tales como nombres de paquetes Java. El valor predeterminado es
io.cordova.hellocordova , pero se recomienda que seleccione un valor apropiado.
El tercer argumento HelloWorld da ttulo de pantalla de la aplicacin. Este argumento es opcional. Puede editar este valor
ms adelante en el config.xml de archivos, pero tenga en cuenta que puede haber cdigo generado fuera de config.xml
utilizando este valor, tales como nombres de clase de Java. El valor predeterminado es HelloCordova , pero se recomienda
que seleccione un valor apropiado.
Aadir plataformas
Todos los comandos posteriores necesitan ejecutarse en el directorio del proyecto, o cualquier subdirectorios dentro de su
mbito de aplicacin:
$cdhello
https://cordova.apache.org/docs/es/latest/guide/cli/ 2/11
12/1/2017 LainterfazdelineadecomandosApacheCordova
Antes de poder construir el proyecto, tienes que especi car un conjunto de plataformas de destino. Su capacidad para
ejecutar estos comandos depende de si tu maquina soporta cada SDK, y si ya tienes instalacin cada SDK. Ejecutar
cualquiera de stos desde un Mac:
$cordovaplatformaddios
$cordovaplatformaddamazonfireos
$cordovaplatformaddandroid
$cordovaplatformaddblackberry10
$cordovaplatformaddfirefoxos
Ejecutar cualquiera de stos desde una mquina Windows, donde wp se re ere a las diferentes versiones del sistema
operativo Windows Phone:
plataforma$cordovaagregar$wp8cordovaplataformaaadirwindowsplataforma$cordovaaadirplataformaamazon
$cordovaplatformsls
Ejecutar cualquiera de los siguientes comandos sinnimos para quitar una plataforma:
$cordovaplatformremoveblackberry10
$cordovaplatformrmamazonfireos
$cordovaplatformrmandroid
Ejecucin de comandos para agregar o quitar afecta a plataformas el contenido del directorio de platforms del proyecto,
donde cada plataforma especi cado aparece como un subdirectorio. El directorio de origen www se reproduce dentro del
subdirectorio de cada plataforma, que aparece por ejemplo en platforms/ios/www o platforms/android/assets/www .
Porque la CLI constantemente copia archivos desde la carpeta www fuente, slo debe editar estos archivos y no los
ubicado debajo de los subdirectorios de plataformas . Si utilizas software de control de versin, debe agregar esta carpeta
www fuente, junto con la carpeta se funde , a su sistema de control de versin. (Puede encontrarse ms informacin sobre
la carpeta se funde en la seccin de personalizar cada plataforma abajo).
ADVERTENCIA: cuando se usa la CLI para construir su solicitud, usted debe no editar cualquiera de los archivos en el
/platforms/ Directorio si no sabes lo que ests haciendo, o si documentacin especi ca lo contrario. Los archivos de este
directorio se sobrescriben rutinariamente al preparar las aplicaciones para la construccin, o cuando son instalar plugins.
Si lo desea en este punto, puede utilizar un SDK como Eclipse o Xcode para abrir el proyecto que ha creado. Usted
necesitar abrir el conjunto derivado de los activos de la /platforms/ Directorio para desarrollar con un SDK. Esto es
porque los archivos de metadatos espec cos del SDK se almacenan dentro de la correspondiente /platform/
subdirectorio. (Vea a las guas de plataforma para obtener informacin sobre cmo desarrollar aplicaciones dentro de cada
IDE). Utilice este enfoque si simplemente quieres inicializar un proyecto mediante la CLI y luego cambiar a un SDK para
trabajo nativo.
Lea sobre si desea utilizar el enfoque de ujo de trabajo multiplataforma (CLI) para el ciclo completo de desarrollo.
Construir la aplicacin
De forma predeterminada, la secuencia de comandos cordovacreate genera una esqueltica aplicacin basada en web
cuya pgina de inicio es el archivo del proyecto www/index.html . Editar esta aplicacin que quieras, pero cualquier
inicializacin debe especi carse como parte de la [deviceready](../../cordova/events/events.deviceready.html)
controlador de eventos, que se hace referencia por defecto de www/js/index.js .
$cordovabuild
Esto genera un cdigo espec co de plataforma dentro del subdirectorio del proyecto platforms . Opcionalmente puede
limitar el alcance de cada build a plataformas espec cas:
https://cordova.apache.org/docs/es/latest/guide/cli/ 3/11
12/1/2017 LainterfazdelineadecomandosApacheCordova
$cordovabuildios
El comando cordovabuild es una abreviatura para el siguiente, que en este ejemplo tambin est orientado a una nica
plataforma:
$cordovaprepareios
$cordovacompileios
En este caso, una vez que prepare , puede utilizar Xcode SDK de Apple como alternativa para modi car y compilar el
cdigo espec co de plataforma que Crdoba se genera dentro de platforms/ios . Puede utilizar el mismo enfoque con
SDK de otras plataformas.
$cordovaemulateandroid
Algunas plataformas mviles emulan un dispositivo especial de forma predeterminada, como el iPhone iOS proyectos. Para
otras plataformas, necesitar primero asociado a un dispositivo con un emulador.
Nota: apoyo emulador no est actualmente disponible para Amazon fuego OS.
(Vea a las guas de la plataforma para ms detalles). Por ejemplo, usted puede ejecuta el comando android para lanzar el
SDK de Android, luego ejecute una imagen del dispositivo en particular, que inicia segn su comportamiento
predeterminado:
Siguiendo con el comando cordovaemulate refresca la imagen de emulador para mostrar la ltima aplicacin, que ahora
est disponible para el lanzamiento de la pantalla de Inicio:
https://cordova.apache.org/docs/es/latest/guide/cli/ 4/11
12/1/2017 LainterfazdelineadecomandosApacheCordova
$cordovarunandroid
Antes de ejecutar este comando, tienes que con gurar el dispositivo para la prueba, siguiendo los procedimientos que
varan para cada plataforma. En los dispositivos Android y Amazon fuego OS, tendras que activar una opcin de
depuracin USB en el dispositivo y quizs aadir un controlador USB dependiendo de su entorno de desarrollo. Ver a las
guias de plataforma para obtener ms informacin sobre los requisitos de cada plataforma.
Un plugin es un poco de cdigo adicional que proporciona una interfaz para componentes nativos. Usted puede disear su
propia interfaz plugin, por ejemplo al disear una aplicacin hbrida que combina un Cordova WebView con componentes
nativos. (Vase WebViews incrustar y Plugin Development Guide
(guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide) para obtener ms detalles). Ms comnmente,
debe agregar un plugin para activar uno de los rasgos bsicos de nivel de dispositivo de Cordova detallados en la
referencia de la API.
A partir de la versin 3.0, cuando se crea un proyecto de Crdoba no tiene presente algn plugin. Este es el nuevo
comportamiento predeterminado. Algn plugin que desee, incluso los plugins del ncleo, debe agregarse explcitamente.
Puede encontrarse una lista de estos plugins, plugins de terceros adicionales proporcionados por la comunidad,
incluyendo en el registro en plugins.cordova.io (http://plugins.cordova.io/). Puede utilizar la CLI para buscar plugins de este
registro. Por ejemplo, buscando bar y code produce un solo resultado que coincide con ambos trminos como
subcadenas entre maysculas y minsculas:
$cordovapluginsearchbarcode
com.phonegap.plugins.barcodescannerScansBarcodes
cordovapluginstatusbarCordovaStatusBarPlugin
El cordovapluginadd comando requiere especi car el repositorio para el cdigo del plugin. Estos son ejemplos de cmo
puede usar la CLI para agregar funciones a la aplicacin:
https://cordova.apache.org/docs/es/latest/guide/cli/ 5/11
12/1/2017 LainterfazdelineadecomandosApacheCordova
$cordovapluginaddcordovaplugindevice
$cordovapluginaddcordovapluginnetworkinformation
$cordovapluginaddcordovapluginbatterystatus
$cordovapluginaddcordovaplugindevicemotion
$cordovapluginaddcordovaplugindeviceorientation
$cordovapluginaddcordovaplugingeolocation
$cordovapluginaddcordovaplugincamera
$cordovapluginaddcordovapluginmediacapture
$cordovapluginaddcordovapluginmedia
$cordovapluginaddcordovapluginfile
$cordovapluginaddcordovapluginfiletransfer
$cordovapluginaddcordovaplugindialogs
$cordovapluginaddcordovapluginvibration
Contactos:
$cordovapluginaddcordovaplugincontacts
Globalizacin:
$cordovapluginaddcordovapluginglobalization
SplashScreen:
$cordovapluginaddcordovapluginsplashscreen
$cordovapluginaddcordovaplugininappbrowser
Consola de depuracin:
$cordovapluginaddcordovapluginconsole
Nota: el CLI agrega plugin cdigo segn proceda para cada plataforma. Si usted quiere desarrollar con las herramientas de
nivel inferior cscara o plataforma SDK como se indica en el Resumen (../overview/index.html), tienes que ejecutar la
utilidad Plugman para aadir plugins por separado para cada plataforma. (Para obtener ms informacin, vase Plugman
usando a gestionar Plugins).
Uso pluginls (o pluginlist , o plugin por s mismo) ver actualmente instalado plugins. Cada muestra por su
identi cador:
$cordovapluginls#or'pluginlist'
['cordovapluginconsole']
https://cordova.apache.org/docs/es/latest/guide/cli/ 6/11
12/1/2017 LainterfazdelineadecomandosApacheCordova
Para quitar un plugin, referirse a l por el mismo identi cador que aparece en el listado. Por ejemplo, aqu es cmo quitara
apoyo para una consola de depuracin de una versin:
$cordovapluginrmcordovapluginconsole
$cordovapluginremovecordovapluginconsole#same
Puede lote-quitar o agregar plugins por especi car ms de un argumento para cada comando:
$cordovapluginaddcordovapluginconsolecordovaplugindevice
$cordovapluginaddcordovapluginconsole
El id tambin puede incluir el nmero de versin del plugin, anexado despus de un @ personaje. El latest versin es
un alias para la versin ms reciente. Por ejemplo:
$cordovapluginaddcordovapluginconsole@latest
$cordovapluginaddcordovapluginconsole@0.2.1
Si el plugin no est registrado en registry.cordova.io , pero se encuentra en otro repositorio git, puede especi car una
URL alternativa:
$cordovapluginaddhttps://github.com/apache/cordovapluginconsole.git
El ejemplo de git anterior recupera el plugin desde el nal de la rama principal, pero una alternativa git-ref como una
etiqueta o rama puede ser aadido despus de un # personaje:
$cordovapluginaddhttps://github.com/apache/cordovapluginconsole.git#r0.2.0
o sucursal:
$cordovapluginaddhttps://github.com/apache/cordovapluginconsole.git#CB8438cordovapluginconsole
$cordovapluginaddhttps://github.com/apache/cordovapluginconsole.git#f055daec45575bf08538f885e09c85a0eba363ff
Si el plugin (y su plugin.xml archivo) est en un subdirectorio dentro del repositorio git, puede especi carlo con un :
personaje. Tenga en cuenta que el # personaje es necesario:
$cordovapluginaddhttps://github.com/someone/aplugin.git#:/my/sub/dir
$cordovapluginaddhttps://github.com/someone/aplugin.git#r0.0.1:/my/sub/dir
Como alternativa, especi que una ruta de acceso local para el directorio que contiene el plugin.xml archivo:
$cordovapluginadd../my_plugin_dir
https://cordova.apache.org/docs/es/latest/guide/cli/ 7/11
12/1/2017 LainterfazdelineadecomandosApacheCordova
Mientras que Crdoba le permite implementar fcilmente una aplicacin para muchas plataformas diferentes, a veces es
necesario aadir personalizaciones. En ese caso, no desee modi car los archivos de cdigo fuente en varios www
directorios dentro del nivel superior platforms directorio, ya que regularmente son reemplazados con el nivel superior
www fuente de la cruz-plataforma del directorio.
En cambio, el nivel superior merges directorio ofrece un lugar para especi car activos a desplegar en plataformas
espec cas. Cada subdirectorio espec co de la plataforma dentro de merges re eja la estructura del directorio de la www
rbol de cdigo fuente, lo que le permite reemplazar o agregar archivos segn sea necesario. Por ejemplo, aqu es cmo
usted utiliza merges para aumentar el tamao de fuente predeterminado para dispositivos Android y Amazon fuego OS:
Editar el www/index.html archivo, aadir un enlace a un archivo CSS adicional, overrides.css en este caso:
<linkrel="stylesheet"type="text/css"href="css/overrides.css"/>
Opcionalmente crear un vaco www/css/overrides.css archivo, que se aplicara para todas las versiones no-Android,
evitando un error de archivo que falta.
Crear un css subdirectorio dentro de merges/android , luego aadir un correspondiente overrides.css archivo.
Especi car CSS que reemplaza el tamao de letra de 12 puntos por defecto especi cado dentro de
www/css/index.css , por ejemplo:
body{fontsize:14px;}
Al reconstruir el proyecto, la versin de Android incluye el tamao de fuente personalizado, mientras que otros
permanecen sin cambios.
Tambin se puede utilizar merges para agregar archivos no presentan en el original www directorio. Por ejemplo, una
aplicacin puede incorporar un gr co de botn en la interfaz de iOS, en merges/ios/img/back_button.png , mientras que la
versin de Android en lugar de otro puede capturar [backbutton](../../cordova/events/events.backbutton.html) eventos
desde el botn de hardware correspondiente.
Comandos de ayuda
Crdoba cuenta con un par de comandos globales, que pueden ayudar si se atranca o experimenta un problema. El help
comando muestra todos los comandos disponibles de Crdoba y su sintaxis:
$cordovahelp
$cordova#same
Adems, puede obtener ayuda ms detallada sobre un comando espec co. Por ejemplo:
$cordovarunhelp
El info comando produce un listado de informacin potencialmente tiles, como instaladas plataformas, plugins,
versiones SDK para cada plataforma y versiones de CLI y node.js :
$cordovainfo
$sudonpmupdategcordova
$sudonpminstallgcordova@3.1.00.2.0
https://cordova.apache.org/docs/es/latest/guide/cli/ 8/11
12/1/2017 LainterfazdelineadecomandosApacheCordova
Ejecute cordovav para ver qu versin se est ejecutando actualmente. Ejecutar el npminfo comando para una lista
ms larga que incluye la versin actual junto a otros nmeros de versin:
$npminfocordova
Cordova 3.0 es la primera versin para compatibles con la interfaz de lnea de comandos descrita en esta seccin. Si est
actualizando desde una versin anterior a 3.0, necesita crear un nuevo proyecto como se describe arriba, entonces copia
activos la mayor aplicacin en el nivel superior www directorio. En su caso, ms detalles sobre la actualizacin a 3.0 estn
disponibles en las guas de la plataforma. Una vez que se actualiza a la cordova interfaz de lnea de comandos y uso npm
update para permanecer vigente, los procedimientos ms desperdiciadores de tiempo descritos all ya no son relevantes.
Cordova 3.0 + todava puede requerir varios cambios a las estructuras de directorios a nivel de proyecto y otras
dependencias. Despus de ejecutar el npm comando arriba actualizar Cordova s mismo, usted puede necesitar garantizar
recursos de su proyecto se ajustan a los requisitos de la versin ms reciente. Ejecutar un comando como el siguiente para
cada plataforma vas a compilar:
$cordovaplatformupdateandroid
$cordovaplatformupdateios
...etc.
More Resources
GENERAL
License (http://www.apache.org/licenses/LICENSE-2.0)
Artwork (/artwork)
DEVELOPMENT
Thanks (http://www.apache.org/foundation/thanks.html)
Security (http://www.apache.org/security/)
Contribute
https://cordova.apache.org/docs/es/latest/guide/cli/ 9/11
12/1/2017 LainterfazdelineadecomandosApacheCordova
Seguira@apachecordova
Copyright 2012, 2013, 2015 The Apache Software Foundation, Licensed under the Apache License, Version 2.0
(http://www.apache.org/licenses/LICENSE-2.0).
Apache and the Apache feather logos are trademarks (http://www.apache.org/foundation/marks/list/) of The Apache
Software Foundation.
"Raleway" font used under license. For details see the attributions page (/attributions/).
https://cordova.apache.org/docs/es/latest/guide/cli/ 10/11
12/1/2017 LainterfazdelineadecomandosApacheCordova
https://cordova.apache.org/docs/es/latest/guide/cli/ 11/11