Guía de la plataforma Android

Esta guía le muestra cómo configurar el entorno de desarrollo SDK para desplegar aplicaciones Cordova para dispositivos Android. Te camina a través del proceso de instalar el SDK de Android, abrir un proyecto de Android en Eclipse SDK y el despliegue en un emulador o dispositivo. Usted necesitará seguir esta guía para por lo menos instalar el SDK de Android, independientemente de que flujo de trabajo que está siguiendo. (Tanto los flujos Web proyecto Dev y Nativos plataforma Dev requieren el SDK de Android para instalarse y accesible vía la ruta).

Vea el siguiente para obtener más información específica de la plataforma:

Las herramientas de línea de comandos anteriores se refieren a las versiones anteriores Cordova 3.0. Ver la interfaz de línea de comandos para obtener información sobre la interfaz actual.

Requisitos y apoyo

Consulte los requisitos del sistema para el SDK de Android.

Cordova soporta Android 2.2, 2.3 y 4.x. Como regla general, las plataformas son desaprobadas como sumergen por debajo del 5% en del Google tablero de distribución.

Los desarrolladores deberían usar la cordova utilidad en conjunción con el SDK de Android. Ver la interfaz de línea de comandos para obtener información como instalarlo, agregar proyectos, entonces construir e implementar un proyecto.

Instalar el SDK de Android desde Developer.Android.com/SDK. El sdk de android se distribuye como un ' adt-paquete ---' archivo. En windows, el adt-paquete viene con un instalador. En OSX y Linux, simplemente descomprimir el 'adt-bundle' en el lugar se almacenan herramientas de desarrollo. Aquí encontrará información más detallada sobre la configuración del SDK de Android

Cordova Herramientas de línea de comandos trabajar, es necesario incluir el SDK tools y platform-tools directorios en su entorno PATH. En Mac, puede utilizar un editor de texto para crear o modificar el ~/.bash_profile archivo, añadir una línea como la siguiente, dependiendo de donde se instala el SDK:

export PATH = ${PATH}: / / adt-bundle/sdk/plataforma-herramientas de desarrollo: / desarrollo/adt-bundle/sdk/herramientas

Esto expone SDK tools en windows terminales recién inauguradas. De lo contrario corre para que estén disponibles en el actual período de sesiones:

$ fuente ~/.bash_profile

Para modificar el entorno PATH en Windows 7:

  • Haga clic en el menú de Inicio en la esquina inferior izquierda del escritorio, haga clic en la computadora, luego haga clic en Propiedades.

  • En la columna de la izquierda, haga clic en Configuración avanzada del sistema .

  • En el cuadro de diálogo resultante, pulse Las Variables de entorno.

  • Seleccionar la variable PATH y pulse Editar.

  • Agregue lo siguiente a la ruta basada en donde se ha instalado el SDK, por ejemplo:

    ;C:\Development\adt-bundle\sdk\platform-tools;C:\Development\adt-bundle\sdk\tools

  • El valor de guardar y cerrar ambos cuadros de diálogo.

También necesitará habilitar Java y Ant. abrir un símbolo del sistema y el tipo java y también de tipo ant . Anexar a la trayectoria de cualquiera que no se puedan ejecutar:

    ;%JAVA_HOME%\bin;%ANT_HOME%\bin

Abrir un proyecto en el SDK

Uso el cordova utilidad para configurar un nuevo proyecto, como se describe en la Córdoba del interfaz de comandos. Por ejemplo, en un directorio del código fuente:

    $ cordova create hello com.example.hello "HelloWorld"
    $ cd hello
    $ cordova platform add android
    $ cordova build

Una vez creado, aquí es cómo utilizar el SDK para modificarlo:

  • Inicie la aplicación de Eclipse .

  • Seleccione el elemento de menú Nuevo proyecto .

  • Elija Proyecto Android de código existente en el cuadro de diálogo resultante y pulse siguiente:

  • Vaya a hello , o cualquier directorio que creó para el proyecto, luego en el platforms/android subdirectorio.

  • Asegúrese de que ambos hello y hello-CordovaLib proyectos son seleccionados para ser importados. El hello-CordovaLib proyecto es necesaria a partir de Cordova 3.3.0 porque Cordova ahora se utiliza como una biblioteca de Android en lugar de un archivo jar.

  • Pulse Finalizar.

Una vez que se abre la ventana de Eclipse, puede aparecer una X de color rojo indicar los problemas irresueltos. Si es así, siga estos pasos adicionales:

  • Haga clic en el directorio del proyecto.

  • En el cuadro de diálogo Propiedades resultante, seleccione Android desde el panel de navegación.

  • Para el proyecto de construcción de destino, seleccione el nivel más alto de la API de Android instalado.

  • Haga clic en Aceptar.

  • Seleccione el menú proyecto limpio . Esto debe corregir todos los errores en el proyecto.

Desplegar en emulador

Puede utilizar la cordova utilidad para ejecutar una aplicación en un emulador, o usted puede ejecutar dentro del SDK. De cualquier manera, el SDK primero debe configurarse para mostrar al menos un dispositivo. Para ello, utilice el Android SDK Manager, una aplicación Java que funciona por separado del Eclipse. Hay dos maneras para abrirlo:

  • Ejecute android en la línea de comandos.

  • Desde dentro de Eclipse, presione este icono de la barra de herramientas:

Una vez abierto, el Android SDK Manager muestra varias bibliotecas de tiempo de ejecución:

Elija Herramientas → administrar AVDs (Android dispositivos virtuales), a continuación elegir cualquier artículo de Definiciones de dispositivos en el cuadro de diálogo resultante:

Pulse Crear AVD, opcionalmente modificar el nombre, luego pulse OK para aceptar los cambios:

La AVD entonces aparece en la lista de Dispositivos Android Virtual :

Para abrir el emulador como una aplicación independiente, seleccione la AVD y presione Start. Se lanza como lo haría en el dispositivo, con controles adicionales disponibles para los botones de hardware:

En este punto se puede utilizar la cordova utilidad para desplegar la aplicación en el emulador desde la línea de comandos:

    $ cordova emulate android

Si en cambio trabajas dentro de Eclipse, haga clic derecho en el proyecto y elija ejecuta como → aplicación para Android. Se le podría especificar una AVD si no aparece ninguna ya abierto.

Para una experiencia más rápida, utilice una imagen de emulador basados en Intel:

  • Instalar uno o más Intel x86 Atom imágenes del sistema así como el Intel Hardware Accelerated Execution Manager , disponible bajo Extras.

  • Ejecute al instalador de Intel, que está disponible en el SDK de Android enextras/intel/Hardware_Accelerated_Execution_Manager.

  • Crear un nuevo AVD con el objetivo fijado a una imagen de Intel.

  • Al iniciar el emulador, asegúrese que no hay error mensajes indicando la imposibilidad de cargar módulos HAX.

Implementar al dispositivo

Para empujar una aplicación directamente al dispositivo, asegúrese de depuración USB está habilitado en el dispositivo como se describe en el Sitio para desarrolladores de Androidy utilice un cable mini-USB para conectarlo a su sistema.

Usted puede empujar la aplicación al dispositivo de la línea de comandos:

    $ cordova run android

Alternativamente dentro de Eclipse, haga clic derecho en el proyecto y elija ejecuta como → aplicación para Android.