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