Convertir JAR a APK

Un dispositivo Android, un emulador o un sistema de implementación empresarial pueden requerir un .apk instalable cuando el software disponible es un .jar de Java. Esto normalmente es una tarea de portabilidad y compilación para Android, no un cambio de extensión de archivo.

Qué contiene un archivo JAR

Un JAR (Java Archive) es un contenedor basado en ZIP utilizado por los desarrolladores de Java para bibliotecas, aplicaciones de escritorio, herramientas de línea de comandos y algunos programas antiguos de Java ME. Normalmente contiene archivos Java .class, recursos y metadatos en META-INF; Maven, Gradle, Eclipse, IntelliJ IDEA y la herramienta jar del JDK suelen generar archivos JAR.

Un JAR de escritorio ejecutable suele declarar una Main-Class en META-INF/MANIFEST.MF y se inicia mediante un runtime estándar de Java. Un JAR de biblioteca proporciona código reutilizable sin un punto de entrada de aplicación. Ningún tipo proporciona inherentemente componentes de Android, recursos de Android, un AndroidManifest.xml utilizable ni una configuración de firma de Android.

Qué contiene un archivo APK

Un APK es un paquete de aplicación de Android. Contiene bytecode DEX para Android Runtime (ART), un manifiesto de Android, recursos compilados, bibliotecas nativas opcionales y firmas del paquete.

Sus ventajas prácticas son que Android puede instalarlo directamente, verificar su certificado de firma e identificar sus actividades, servicios, permisos y dispositivos compatibles declarados. Para los nuevos envíos públicos a Google Play, utiliza en su lugar un Android App Bundle (.aab); Google Play genera APK específicos para cada dispositivo a partir del bundle.

Comprueba el JAR antes de intentar una compilación

Con un JDK instalado, enumera el contenido del archivo:

jar tf input.jar

Busca META-INF/MANIFEST.MF, directorios de paquetes de Java, recursos y dependencias. Un JAR que utilice Swing, AWT, JavaFX, un método main() de escritorio, rutas de archivos locales sin restricciones o bibliotecas de escritorio específicas de una plataforma no puede convertirse en una aplicación Android funcional simplemente reempaquetándolo.

Un JAR que sea únicamente una biblioteca de propósito general puede utilizarse en un proyecto de Android. Una aplicación de escritorio completa normalmente requiere adaptar su código fuente para Android.

Compila un APK de Android a partir del código fuente

1. Instala Android Studio e instala la plataforma del SDK necesaria mediante Tools → SDK Manager.
2. Crea un proyecto de Android mediante File → New → New Project. Selecciona Java si el código existente está escrito en Java; Kotlin también es compatible, pero no es necesario para la migración.
3. Mueve el código Java reutilizable al módulo de la aplicación, normalmente app/src/main/java. Sustituye el punto de entrada main() de escritorio por una Activity, un servicio, un receptor u otro componente de Android declarado.
4. Sustituye el código de interfaz de usuario de escritorio por vistas de Android, layouts o Jetpack Compose; Android no proporciona Swing, AWT ni JavaFX como lo hace un runtime de Java de escritorio.
5. Adapta el almacenamiento, las redes, las notificaciones, el trabajo en segundo plano y los permisos a las API de Android. Por ejemplo, el acceso a la red requiere <uses-permission android:name="android.permission.INTERNET" /> en el manifiesto del proyecto.
6. Configura el ID de aplicación, la versión mínima del SDK, la versión de destino del SDK, los iconos, los recursos y los componentes del manifiesto. Prueba en un emulador y en dispositivos reales con las versiones de Android compatibles.
7. Crea un APK de depuración con ./gradlew assembleDebug en macOS/Linux o gradlew.bat assembleDebug en Windows. El resultado habitual es app/build/outputs/apk/debug/app-debug.apk.
8. Crea un APK de lanzamiento desde Build → Generate Signed Bundle / APK → APK. Fírmalo con un keystore bajo tu control y conserva el keystore, el alias y las contraseñas.

Utiliza un JAR compatible como biblioteca

Copia un JAR de biblioteca en app/libs y añádelo a las dependencias de Gradle del módulo de la aplicación:

implementation(files("libs/library.jar"))

El Android Gradle Plugin convierte los archivos de clase Java compatibles a DEX durante la compilación. Añade por separado las dependencias de terceros necesarias mediante Gradle; no asumas que todas las dependencias utilizadas por el JAR original están incluidas en él o funcionan en Android.

Archivos JAR de Java ME y convertidores en línea

Los juegos y las aplicaciones antiguos de Java ME suelen utilizar un .jar junto con un descriptor .jad opcional. J2ME Loader puede ejecutar muchos de ellos mediante emulación, pero no convierte el programa original en un APK nativo independiente. Una versión nativa para Android requiere el código fuente y una reescritura para Android.

Ningún servicio en línea acreditado puede convertir de forma fiable un JAR arbitrario en un APK funcional, porque los puntos de entrada, la interfaz de usuario, los permisos, las dependencias y las sustituciones de API de Android son específicos de cada aplicación. Evita los convertidores basados en la carga de archivos que prometen una conversión «con un clic», especialmente para código propietario; no pueden crear de forma segura una aplicación mantenible ni permitirte conservar el control exclusivo de tu clave de firma de lanzamiento.

Compatibilidad y límites de lanzamiento

ART ejecuta DEX, no archivos de clase JVM normales. D8 puede traducir bytecode compatible, pero no hace que las API de Java SE de escritorio estén disponibles en Android. Es posible que los JAR compilados para una versión de archivo de clase Java no compatible deban recompilarse a partir del código fuente; algunas características del lenguaje y bibliotecas requieren desugaring de Android o sustituciones específicas de Android.

La reflexión, las clases cargadas dinámicamente, la reducción de código, las bibliotecas nativas y las arquitecturas de CPU específicas del dispositivo requieren una configuración de compilación y pruebas explícitas. El código descompilado a veces puede ayudar a recuperar un proyecto perdido, pero puede estar incompleto, ser difícil de mantener y estar restringido por la licencia del software.

Una aplicación instalada solo puede actualizarse con el mismo ID de aplicación y la misma clave de firma. Cambiar cualquiera de ellos hace que Android trate el APK como una aplicación diferente en lugar de una actualización.