miércoles, 30 de julio de 2014

Crea tu primera aplicación con PhoneGap

Para crear tu primera aplicación con PhoneGap hay que seguir los siguientes pasos:
  1. Instalar NodeJS. Desde la versión 3.0 e PhoneGap la instalación se realiza mediante NodeJS. Descargar el instalador desde la web de NodeJS y seguir los pasos de instalación.

  2. Una vez instalado NodeJS abrir un terminal y ejecutar el siguiente comando.
    > npm install -g phonegap
    Con esto se habrán descargado desde el repositorio oficial todos los paquetes necesarios para crear aplicaciones con PhoneGap

  3. Desde el terminal, nos dirigimos al directorio donde se vamos a crear nuestra aplicación. Desde ahí ejecutamos el siguiente comando.
    > phonegap create my-first-app

    Comprobamos que se ha creado un directorio my-first-app
    >cd my-first-app
    >dir


    Comprobamos que dentro de este directorio tenemos 4 nuevas carpetas: hooks, platforms, plugins, www

  4. Para compilar la aplicación de forma remota mediante PhoneGap Build para la versión de Android, ejecutamos el siguiente comand. Nos pedirá un usuario y contraseña
    > phonegap remote run android

    Esta acción nos devuelve un código QR . Con esta compilación, no disponemos de la aplicación en local, se ha generado de forma online con la plataforma PhoneGap Build.

    La aplicación remota la podremos ver en la página de Adobe PhoneGap Build. Para compilar con PhoneGap Build necesitamos disponer de cuenta de ID de Adobe o de GIT. Con la cuenta gratuita PhoneGap Build solo nos permite subir una aplicación. También se puede subir la aplicación directamente desde la página subiendo en un ZIP la carpeta www de la aplicación, en vez de hacerlo por línea de comandos.

  5. Para ejecutar la aplicación en local
    > phonegap local run android
    Se abrirá un emulador que cargará la aplicación si no hay ningún emulador ya ejecutándose.

NOTA 1: También se puede ejecutar para otras plataformas (en este caso iOs) con el comando
> phonegap run ios


NOTA 2: Para ejecutar la aplicación en Android, deberemos tener instalado el SDK de Android y configuradas las siguientes variables de entorno:

ANDROID_HOME = C:\ADT\adt-bundle-windows-x86_64-20140702\sdk
ANDROID_PLATFORM_TOOLS = C:\ADT\adt-bundle-windows-x86_64-20140702\sdk\platform-tools
ANDROID_TOOLS = C:\ADT\adt-bundle-windows-x86_64-20140702\sdk\tools
ANT_HOME = C:\apache-ant-1.9.4-bin\apache-ant-1.9.4

Incluir estas variables en el PATH

PATH = %ANDROID_HOME%\tools;%ANDROID_PLATFORM_TOOLS%;%ANT_HOME%\bin;

Atención: la versión de ant debe ser superior a 1.6

NOTA 3: Es necesario tener instalado GIT en nuestro PC, sino durante la instalación de PhoneGap nos aparecerá un error. 

NOTA 4: Si aparece el error Failure [INSTALL_FAILED_OLDER_SDK] hay que comprobar que la versión de android:minSdkVersion="" del fichero AndroidManifest.xml es igual o menor a la API con la que se ejecuta el emulador donde se instala la aplicación y que dicha API está instalada en nuestro ordenador.