Convertir ZIP a AAR

Una biblioteca de Android puede distribuirse como un ZIP aunque Android Studio o Gradle requieran una dependencia AAR. La acción necesaria es reconstruir el proyecto de la biblioteca o confirmar que el ZIP ya tiene la estructura de un AAR; cambiar .zip por .aar normalmente no es una conversión.

Qué es el formato ZIP

ZIP es un formato de archivo de uso general para agrupar y comprimir archivos. Los desarrolladores lo utilizan para proyectos de código fuente de Android, paquetes de SDK, código de ejemplo, archivos compilados y distribuciones de lanzamiento; Windows, macOS, Linux, 7-Zip y los sistemas de compilación pueden crearlo y extraerlo.

ZIP no impone ninguna estructura de directorios específica de Android. Inspecciona el archivo antes de elegir un método de conversión: puede contener un proyecto completo de Gradle, una biblioteca ya empaquetada, archivos de código fuente o archivos no relacionados.

Qué es el formato AAR

AAR, o Android Archive, es el formato de paquete producido para un módulo de biblioteca de Android. Android Gradle Plugin y Android Studio pueden utilizarlo como una dependencia local, y un repositorio Maven puede distribuirlo con sus metadatos correspondientes.

Un AAR es técnicamente un archivo ZIP con una estructura de biblioteca de Android. Un AAR normal contiene AndroidManifest.xml, classes.jar, res/ y R.txt; también puede contener assets/, jni/, libs/, prefab/, public.txt, proguard.txt, lint.jar y otras entradas compatibles. Puede empaquetar bytecode compilado de Java o Kotlin, recursos de Android, declaraciones del manifiesto, bibliotecas nativas y reglas de R8 o ProGuard para consumidores. A diferencia de un JAR simple, puede incluir recursos de Android y componentes nativos.

Cómo convertir un ZIP que contiene un proyecto de biblioteca

1. Extrae el ZIP con 7-Zip, la utilidad de archivos del sistema o Android Studio. Busca settings.gradle o settings.gradle.kts y un módulo que contenga build.gradle o build.gradle.kts.
2. Confirma que el módulo de destino aplica el plugin de biblioteca de Android, como com.android.library, en lugar de com.android.application. No cambies un módulo de aplicación a una biblioteca sin comprobar su manifiesto, dependencias y configuración de compilación.
3. Abre el proyecto extraído en Android Studio, instala las versiones del SDK y de build-tools solicitadas por el proyecto y permite que finalice la sincronización de Gradle. Resuelve los repositorios, plugins y dependencias faltantes antes de compilar.
4. Compila la variante release desde Android Studio con Build → Make Project, o ejecuta la tarea del módulo desde el directorio del proyecto:

./gradlew :library:assembleRelease

En Windows, ejecuta gradlew.bat :library:assembleRelease. Reemplaza library por el nombre real del módulo. El resultado normalmente se encuentra en library/build/outputs/aar/, por ejemplo, library-release.aar. Utiliza la tarea debug solo cuando se requiera específicamente un AAR debug.

Cómo gestionar un ZIP que ya es un AAR

Abre el archivo con 7-Zip u otra utilidad de archivos e inspecciona su nivel superior. Si tiene la estructura de un AAR, incluidos AndroidManifest.xml, classes.jar, res/ y R.txt, es posible que se le haya asignado la extensión incorrecta. Haz una copia y cámbiale el nombre:

mv library.zip library.aar

En Windows:

ren library.zip library.aar

Si los archivos están anidados dentro de un directorio adicional, vuelve a empaquetar el contenido para que esas entradas se encuentren en la raíz del archivo. Cambiar el nombre o volver a empaquetar no compila el código fuente, procesa los recursos, genera R.txt ni añade un manifiesto. Prueba el AAR resultante en una aplicación pequeña de Android.

Cómo gestionar archivos de código fuente o archivos arbitrarios

Un ZIP que contenga únicamente .java, .kt, .class, documentos o carpetas arbitrarias no se puede convertir de forma fiable mediante un convertidor de archivos. Crea o abre un módulo de biblioteca de Android, coloca el código fuente en src/main/java/ o src/main/kotlin/, coloca los recursos en src/main/res/, coloca los assets en src/main/assets/, configura el manifiesto y las dependencias y ejecuta assembleRelease.

Los archivos nativos deben utilizar los directorios ABI esperados, como src/main/jniLibs/arm64-v8a/. Android Gradle Plugin debe compilar el código y los recursos; una utilidad ZIP general no puede realizar estos pasos.

Herramientas de escritorio y en línea

Android Studio con Gradle es la opción de escritorio adecuada cuando el ZIP contiene código fuente o un proyecto de Gradle. 7-Zip, Finder, File Explorer y las herramientas de línea de comandos unzip o zip son apropiadas para la inspección y el reempaquetado simple.

Los servicios de archivos en línea, como CloudConvert o Zamzar, pueden admitir el reempaquetado genérico de ZIP o la conversión de extensiones, pero no pueden resolver dependencias de Android ni compilar un AAR. Utiliza un servicio en línea únicamente para un archivo no confidencial que ya tenga el contenido correcto de un AAR; no subas código fuente propietario, SDK, material de firma ni bibliotecas privadas.

Comprobaciones de compatibilidad

Antes de distribuir el resultado, abre el AAR como un ZIP y verifica su manifiesto, classes.jar, recursos, bibliotecas nativas, assets y reglas para consumidores. Pruébalo con Android Gradle Plugin, compile SDK, versión de Kotlin y ABI de dispositivos compatibles del proyecto consumidor.

Un AAR no incluye automáticamente todas las dependencias externas de Maven. Es posible que los consumidores deban declarar esas dependencias por separado, y una dependencia de archivo local no proporciona los metadatos de dependencias que ofrece una publicación de Maven. Añade un AAR local con una dependencia de Gradle como implementation files('libs/library-release.aar'), o publica el AAR en un repositorio Maven con sus metadatos POM y de módulo.