La herramienta de línea de comandos para crear, implementar y administrar Cordova-aplicaciones basadas en.
Cordova de Apache permite construir aplicaciones móviles nativas usando HTML, CSS y JavaScript. Esta herramienta ayuda a gestión de aplicaciones en múltiples plataformas Córdoba así como la integración de plugin de Córdoba.
Compruebe hacia fuera las guías de introducción para obtener más información sobre cómo trabajar con sub-proyectos Córdoba.
tools
y platform-tools
directorios en su ruta del sistema de lo contrario Android soporte fallará.msbuild
en su ruta del sistema de lo contrario dejará de soporte de Windows Phone (msbuild.exe
está generalmente situado en C:\Windows\Microsoft.NET\Framework\v4.0.30319
).dependencias/herramientas/bin
dentro del directorio SDK añade a tu camino!Xcode
Xcode herramientas de línea de comandos
msbuild
en su ruta del sistema de lo contrario dejará de soporte de Windows Phone (msbuild.exe
está generalmente situado en C:\Windows\Microsoft.NET\Framework\v4.0.30319
).Cordova-cli
se ha probado en Mac OS X, Linux, Windows 7y Windows 8.
Tenga en cuenta que algunas plataformas de tengan restricciones de sistema operativo. Por ejemplo, se puede construir para Windows 8 y Windows Phone 8 en Mac OS X, tampoco puede construir para iOS en Windows.
Paquetes de Ubuntu están disponibles en un PPA para Ubuntu 13.10 (Saucy) (la versión actual), así como 14.04 (fiel) (en desarrollo).
sudo apt-add-repository ppa:cordova-ubuntu/ppa sudo apt-get update sudo apt-get install cordova-cli npm install -g cordova
Para construir una aplicación para la plataforma de Ubuntu, son necesarios los siguientes paquetes adicionales:
sudo apt-get install cmake debhelper libx11-dev libicu-dev pkg-config qtbase5-dev qtchooser qtdeclarative5-dev qtfeedback5-dev qtlocation5-dev qtmultimedia5-dev qtpim5-dev qtsensors5-dev qtsystems5-dev
Usted necesitará instalar la CLI y Plugman de git
. Ejecuta la versión del npm de uno y versión principal (git) de la otra es probable que al terminar usted sufren.
Para evitar el uso de sudo, ver alejarse de sudo: npm sin raíz.
Ejecute los comandos siguientes:
git clone https://git-wip-us.apache.org/repos/asf/cordova-plugman.git cd cordova-plugman npm install sudo npm link cd .. git clone https://git-wip-us.apache.org/repos/asf/cordova-cli.git cd cordova-cli npm install sudo npm link npm link plugman
Ahora el cordova
y plugman
en tu camino son las versiones de git local. No te olvides de mantenerlas hasta la fecha.
apt-get install cordova-cli
Cordova-cli
tiene un comando global solo create
que crea nuevos proyectos de Córdoba en un directorio especificado. Una vez que se crea un proyecto, cd
y se puede ejecutar una variedad de comandos de nivel de proyecto. Totalmente inspirado en la interfaz de git.
help
muestra una página de ayuda con todos los comandos disponiblescreate <directory> [<id> [<name>]]
crea un nuevo proyecto de Cordova con nombre opcional y el identificador (nombre del paquete, estilo de dominio reverso)platform [ls | list]
lista de todas las plataformas para que el proyecto se basaráplatform add <platform> [<platform> ...]
Añadir plataformas uno (o más) como un objetivo de construcción del proyectoplatform [rm | remove] <platform> [<platform> ...]
quita uno (o más) objetivos de construcción de plataforma del proyectoplatform [up | update] <platform>
-actualiza la versión de Córdoba utilizada la plataforma dadaplugin [ls | list]
lista todos los plugins incluidos en el proyectoplugin add <path-to-plugin> [<path-to-plugin> ...]
Añadir plugins uno (o más) para el proyectoplugin [rm | remove] <plugin-name> [<plugin-name> ...]
quitar plugins uno (o más) del proyecto.plugin search [<keyword1> <keyword2> ...]
busca el registro de plugin para plugins que empareja la lista de palabras clave de búsquedaprepare [platform...]
copia los archivos en las plataformas especificadas, o todas las plataformas. Entonces está listo para edificio por Eclipse
, Xcode
, etc.compile [platform...]
compila la aplicación en un archivo binario para cada plataforma dirigido. Sin parámetros, estructuras para todas las plataformas, de lo contrario construye para las plataformas especificadas.construir [< plataforma > [< plataforma > [...]]]
seguida de un alias para cordova prepare
cordova compile
emulate [<platform> [<platform> [...]]]
lanzamiento de emuladores y desplegar la aplicación en ellos. Sin parámetros emula para todas las plataformas ha añadido al proyecto, emula lo contrario para las plataformas especificadasserve [port]
en marcha un servidor web local lo que le permite acceder a directorio de www de cada plataforma en el puerto determinado (por defecto 8000).-d
o --verbose
envía una salida más verbosa a su shell. También puede suscribirse a eventos de log
y advertir
si eres consumidor cordova-cli
como módulo nodo llamando a cordova.on ('log', function() {})
o cordova.on ('warn', function() {})
.-v
o --version
instalará imprimir la versión de su Córdoba-cli
.Una aplicación de Cordova con cordova-cli
tendrá la siguiente estructura de directorios:
myApp/ |-- config.xml |-- hooks/ |-- merges/ | | |-- android/ | | |-- blackberry10/ | | `-- ios/ |-- www/ |-- platforms/ | |-- android/ | |-- blackberry10/ | `-- ios/ `-- plugins/
Este directorio puede contiene secuencias de comandos se usa para personalizar los comandos cli de Córdoba. Este directorio solía existir en los .cordova/hooks
, pero ahora se ha movido a la raíz del proyecto. Cualquier scripts que añadir a estos directorios se ejecutarán antes y después de los comandos correspondientes a nombre del directorio. Útil para integrar su propio sistema de construcción o integración con sistemas de control de versiones.
Para más información, consulte Guía de ganchos .
Activos específicos de la plataforma web (archivos HTML, CSS y JavaScript) están contenidos en las subcarpetas correspondientes en este directorio. Estos se despliegan durante un prepare
el directorio nativo apropiado. Archivos colocados bajo merges/
sobrescribirá los archivos coincidentes en el www /
carpeta para la plataforma correspondiente. Un ejemplo rápido, si se asume que una estructura de proyecto de:
merges/ |-- ios/ | `-- app.js |-- android/ | `-- android.js www/ `-- app.js
Después de construir los proyectos de Android y iOS, la aplicación Android contendrá app.js
y android.js
. Sin embargo, la aplicación de iOS sólo contendrá un app.js
, y será uno de merges/ios/app.js
, reemplazando el “común” app.js
ubicado dentro de www /
.
Contiene artefactos de la web del proyecto, tales como ficheros .html, .css y .js. Estos son los activos de principal de la aplicación. Se copiarán en una Córdoba prepara
al directorio www de cada plataforma.
Este archivo es usted debe editar para modificar los metadatos de la aplicación. Cualquier momento que ejecutar cualquier comando de cordova-cli, la herramienta Buscar en el contenido del archivo config.xml
y utilice toda la información relevante de este archivo para definir información de aplicación nativa. Cordova-cli admite cambiar datos de su aplicación a través de los siguientes elementos dentro del archivo config.xml
:
<name>
.id
del elemento de nivel superior < widget >
.version
del elemento de nivel superior < widget >
.acceso < a >
. Asegúrese de que el atributo de origin
sus < > elemento de puntos de access
a una dirección URL válida (usted puede utilizar *
como comodín). Para obtener más información sobre la sintaxis de las listas blancas, vea docs.phonegap.com. Usted puede utilizar el atributo uri
(propietaria de BlackBerry) u origin
(estándares) para denotar el dominio.<preference>
. Consulte docs.phonegap.com para obtener una lista de preferencias que se puede utilizar.<content src>
+ atributo.Añadido a la aplicación de plataformas tendrá la aplicación nativa proyecto estructuras establecidas dentro de este directorio.
Cualquier añadidos plugins serán extraídos o copiados en este directorio.
Proyectos creados por cordova-cli tienen antes
y después de
ganchos para cada comando proyecto.
Hay dos tipos de ganchos: los proyectos específicos y los de nivel de módulo. Ambos de estos tipos de ganchos reciben la carpeta raíz del proyecto como parámetro.
Estos están ubicados en el directorio de ganchos
en la raíz de su proyecto de Cordova. Cualquier scripts que añadir a estos directorios se ejecutarán antes y después de los comandos apropiados. Útil para integrar su propio sistema de construcción o integración con sistemas de control de versiones. Recuerde: hacer sus scripts ejecutables. Para más información, consulte Guía de ganchos .
Si usas cordova-cli como un módulo dentro de una mayor aplicación de node , puede usar los métodos estándar de EventEmitter
para sujetar a los acontecimientos. Los eventos incluyen before_build
, before_compile
, before_docs
, before_emulate
, before_run
, before_platform_add
, before_library_download
, before_platform_ls
, before_platform_rm
, before_plugin_add
, before_plugin_ls
, before_plugin_rm
y before_prepare
. También es un evento de progreso library_download
. Además, hay after_
de sabores de todos los eventos antes mencionados.
Una vez require('cordova')
en su proyecto de nodo, tendrá los habituales EventEmitter
métodos disponibles (on
, off
o removeListener
, removeAllListeners
y emit
o trigger
).
Este ejemplo muestra cómo crear un proyecto desde cero llamado KewlApp con el apoyo de la plataforma Android y iOS e incluye un plugin llamado Kewlio. El proyecto va a vivir a ~/KewlApp
cordova create ~/KewlApp KewlApp cd ~/KewlApp cordova platform add ios android cordova plugin add http://example.org/Kewlio-1.2.3.tar.gz cordova build
La estructura de directorios de KewlApp ahora se ve así:
KewlApp/ |-- hooks/ |-- merges/ | |-- android/ | `-- ios/ |-- www/ | `-- index.html |-- platforms/ | |-- android/ | | `-- … | `-- ios/ | `-- … `-- plugins/ `-- Kewlio/
npm test
npm run cover
Por favor compruebe Cordova aspectos con el componente de CLI. Si encuentras problemas con esta herramienta, por favor sea tan amable como para incluir información relevante necesaria para depurar problemas tales como:
create
Xcode
si están presentando temas relacionados con iOSGracias a todos por su contribución! Para una lista de personas involucradas, por favor, consulte el archivo package.json
.
Cordova-cli
utilizar configuración de proxy del NPM
. Si descargaste cordova-cli mediante NPM
y están detrás de un proxy, lo más probable es cordova-cli debe trabajar para usted ya que utilizará los valores en primer lugar. Asegúrese de que el npm config variables proxy
y proxy https
están ajustadas correctamente. Consulte la documentación de configuración del NPM para obtener más información.
Al intentar agregar una plataforma en una máquina Windows si ejecuta en el siguiente mensaje de error: biblioteca Córdoba para “android” ya existe. No hay necesidad de descargar. Continuando. Comprobar si la plataforma “android” pasa requisitos mínimos... Comprobación de requisitos de Android... Funcionamiento “target android lista” (salida a seguir)
Error: The command `android` failed. Make sure you have the latest Android SDK installed, and the `android` command (inside the tools/ folder) added t o your path. Output: at C:\Users\me\AppData\Roaming\npm\node_modules\cordova\src\platform.js:185:42 at C:\Users\me\AppData\Roaming\npm\node_modules\cordova\src\metadata\android_parser.js:50:13 at C:\Users\me\AppData\Roaming\npm\node_modules\cordova\node_modules\shelljs\shell.js:1707:7 at exithandler (child_process.js:633:7) at ChildProcess.errorhandler (child_process.js:649:5) at ChildProcess.EventEmitter.emit (events.js:95:17) at Process.ChildProcess._handle.onexit (child_process.js:787:12)
Ejecute el comando target list android
. Si ves:
'xcopy' is not recognized as an internal or external command, operable program or batch file.
al principio de la salida del comando, que significa que usted necesitará fijar la variable Path de Windows para incluir xcopy. Esta ubicación suele estar en C:\Windows\System32.
Soporte Windows 8 no incluye la capacidad de lanzamiento/run/emular, por lo que necesitarás abrir Visual Studio para ver su aplicación en vivo. Eres todavía capaz de usar los siguientes comandos con windows8:
platform add windows8
platform remove windows8
prepare windows8
compile windows8
build windows8
Para ejecutar la aplicación, usted necesitará abrir .sln
en la carpeta de platforms/windows8
usando Visual Studio 2012.
Visual Studio le dirá que vuelva a cargar el proyecto si se ejecuta cualquiera de los comandos anteriores mientras se carga el proyecto.
Amazon Fire OS no incluyen la capacidad de emular. Todavía puede utilizar los siguientes comandos con Amazon fuego OS
platform add amazon-fireos
platform remove amazon-fireos
prepare amazon-fireos
compile amazon-fireos
build amazon-fireos
La versión inicial de cordova-ubuntu no permite desarrollo de aplicaciones para dispositivos armhf automáticamente. Es posible crear aplicaciones y haga clic en paquetes en unos pocos pasos sin embargo.
Este informe documenta el problema y las soluciones para: https://bugs.launchpad.net/ubuntu/+source/cordova-ubuntu/+bug/1260500 una versión futura permitirá desarrolladores cross-compilar armhf haga clic en paquetes directamente desde un escritorio de x 86.
Firefox OS no incluyen la capacidad de emular, ejecutar y servir. Después de la construcción, tienes que abrir el directorio de plataforma firefoxos
de su aplicación en el WebIDE que viene con cada navegador Firefox. Puede mantener abierta esta ventana y haga clic en el botón “play” cada vez que terminado de construir tu aplicación.