Abe Estrada

Phonegap (Apache Cordova) + Android

Estuve haciendo algunas pruebas con Phonegap ahora llamado “Apache Cordova” para desarrollar en Android y me fu difícil conseguir documentación sobre como crear un proyecto básico, utlizando linea de comando (no soy fan de Eclipse ) y con solamente los archivos necesarios para iniciar con este framework. Por tal motivo, voy a documentar lo que hice para posterior uso y ojalá a alguien ms le sea útil.

Primero se debe crear un proyecto.

android create project \
--target <target_ID> \
--name <your_project_name> \
--path path/to/your/project \
--activity <your_activity_name> \
--package <your_package_namespace>

Para ms información puede ir a la documentación oficial Managing Projects from the Command Line .

Depués de haber creado el proyecto, se debe copiar el archivo cordova-1.5.x.jar a el folder libs/ dentro del proyecto, este archivo se puede obtener desde el repositorio de Phonegap en GitHub .

Se debe modificar el ócdigo de la actividad principal (el archivo se encuentra dentro de el folder src/). Primero importamos phonegap con la siguiente linea import org.apache.cordova.*; luego cambiamos Activity por DroidGap en la clase principal y por último, modificamos la linea setContentView(R.layout.main); dentro de la clase por super.loadUrl("file:///android_asset/www/index.html");. El código resultante es muy parecido a este ejemplo:

package com.changoleon.hellophonegap;

import android.app.Activity;
import android.os.Bundle;
import org.apache.cordova.*;

public class Main extends DroidGap {
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    super.loadUrl("file:///android_asset/www/index.html");
  }
}

También tenemos que crear un subfolder dentro del folder res/ llamado res/xml/ y agregar los archivos cordova.xml y plugins.xml que se pueden descargar desde GitHub .

Luego hay que agregar el permiso para que la aplicación pueda conectarse a Internet <uses-permission android:name="android.permission.INTERNET" /> al archivo AndroidManifest.xml que se encuentra en el folder del proyecto.

Y por último hay que crear los folders assets/www/ y agregar un archivo llamado index.html con el contenido en HTML que queramos.

Solo falta compilar el proyecto (ant debug install) y verificar que el BUILD se haya realizado con éxito.

Estos son los pasos para crear un proyecto con la menor cantidad de archivos necesarios para utilizar Phonegap .

Actualización: He actualizado el cdigo ahora que PhoneGap se llama Apache Cordova desde la versin 1.5.0