Para configurar un entorno de desarrollo con Cordova y Node.js orientado a la creación de aplicaciones Android, es esencial manejar cuidadosamente las versiones de las herramientas involucradas para evitar conflictos. A continucaión, se presenta una guía práctica basada en combinaciones probadas de software que garantizan estabilidad durante el proceso de empaquetado.

Instalación de Node.js

Descargue el instalador de Node.js apropiado para su sistema operativo desde el sitio oficial y ejecute el asistente de configuración. Una vez completado, establezca las variables de entorno del sistema para Node.js. Para confirmar que la instalación fue exitosa, abra una consola y ejecute:

node -v

La aparición de un número de versión, como la 18.17.1, indica que Node.js está correctamante instalado.

Instalación de Cordova

Utilice npm para instalar Cordova a nivel global mediante el siguiente comando:

npm install -g cordova

Verifique la instalación ejecutando:

cordova -v

Si se muestra la versión de Cordova (por ejemplo, 12.0.0), el procedimiento fue satisfactorio.

Configuración de Java

Instale el JDK (Java Development Kit), preferiblemente la versión 17, ya que ha demostrado compatibilidad con Cordova. Descargue el paquete desde Oracle y siga las instrucciones de instalación. Defina la variable de entorno JAVA_HOME para que apunte al directorio de instalación del JDK, como C:\Program Files\Java\jdk-17. Para validar, ejecute en la consola:

java -version

La salida debe reflejar la versión instalada del JDK.

Instalación de Gradle

Obtenga Gradle desde su página oficial, descomprímalo en una carpeta accesible y agregue la ruta de su directorio binario a la variable de entorno PATH. Por ejemplo, si Gradle se instaló en C:\Gradle\gradle-8.3, incluya C:\Gradle\gradle-8.3\bin en PATH. Confirme la configuración con:

gradle -v

La versión mostrada, idealmente la 8.3, indica que Gradle está listo para usarse.

Configuración del SDK de Android

Instale Android Studio, asegurándose de incluir el SDK de Android durante el proceso. Configure las variables de entorno ANDROID_SDK_ROOT y ANDROID_HOME, ambas asignándolas a la ruta del SDK, como C:\Users\usuario\AppData\Local\Android\Sdk. Adicionalmente, agregue las siguientes rutas a la variable PATH del sistema:

%ANDROID_SDK_ROOT%\platform-tools\
%ANDROID_SDK_ROOT%\cmdline-tools\latest\bin\
%ANDROID_SDK_ROOT%\emulator\

Ejecute el comando adb en la consola para verificar que el SDK está configurado correctamente, mostrando información del dispositivo si está conectado.

Uso básico de Cordova

Cree un proyecto Cordova y genere el APK para Android siguiendo estos pasos en la consola:

cordova create miapp com.ejemplo.miapp MiApp
cd miapp
cordova platform add android
cordova platform ls
cordova requirements
cordova build
cordova run

Si la ejecución es exitosa, el archivo APK se encontrará en la ruta platforms\android\app\build\outputs\apk\debug\debug.apk, listo para transferirse a un dispositivo con Android 12.0 o superior.