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