Utilizar ficheros .aar en eclipse

Cada vez es más normal encontrar librerías para Android en formato .aar. De hecho, muchas de las bibliotecas que forman parte de la “L” Developer Preview solo están disponibles en este formato. Si usas Android Studio no vas a tener ningún tipo de problema para hacer uso de estas, el problema viene si trabajas con Eclipse. Hasta hace poco, el plugin de maven para Eclipse, no soportaba este tipo de archivos. Por suerte, este plugin ya soporta ficheros .aar. Os dejo un link al tutorial de cómo instalar el plugin en eclipse.

Es posible que esta sea la forma más cómoda, siempre que tengas conocimientos de maven y vayas a crear un proyecto nuevo. Si no es así, si no tienes conocimientos de maven, de cómo crear un fichero pom o ya tienes un proyecto creado, es posible que busques otra forma de poder utilizar la librería .aar sin tener que pasar por el plugin de maven para Eclipse.

Más adelante voy a describir los pasos a seguir para poder usar la librería en Eclipse sin tener que usar el plugin de maven, pero antes vamos a ver qué es un fichero .aar.

Un fichero .aar no es más que un fichero zip con el siguiente contenido:

• /AndroidManifest.xml (fichero obligatorio)
• /classes.jar (fichero obligatorio)
• /res/ (carpeta obligatoria)
• /R.txt (fichero obligatorio)
• /assets/ (carpeta opcional)
• /libs/*.jar (carpeta opcional)
• /jni/*.so (carpeta opcional)
• /proguard.txt (fichero opcional)
• /lint.jar (fichero opcional)

Como verás, dentro del fichero .aar tienes todo lo necesario para poder hacer funcionar la librería en eclipse.

1. Créate un nuevo proyecto (a partir de ahora proyecto librería) en tu workspace. No te olvides de marcarlo como librería.
2. Deja vacía la carpeta src del proyecto librería.
3. Descomprime el fichero .aar. Puedes renombrarlo a .zip y descomprimir o usar alguna herramienta.
4. Copia el fichero classes.jar del fichero .aar a la carpeta libs del proyecto librería.
5. Reemplaza la carpeta res del proyecto librería con la carpeta res del fichero .aar.

Ya has creado el proyecto que contiene casi todo lo que necesitas. Ahora vamos a ver cómo configurar tu proyecto para hacer referencia al proyecto librería:

1. En el proyecto en el que quieres utilizar la librería (a partir de ahora, proyecto objetivo) añade como dependencia el proyecto librería.
2. Abre el archivo AndroidManifest.xml dentro del fichero .aar y asegúrate de copiar todo lo que haga falta (permisos, actividades, servicios, receivers…) en el fichero AndroidManifest.xml del proyecto objetivo.
3. En caso de existir, copia todo el contenido de la carpeta assets del fichero .aar en la carpeta assets del proyecto objetivo.
4. En caso de existir, copia todo el contenido de la carpeta libs del fichero .aar en la carpeta libs del proyecto objetivo.
5. Haz un Clean del workspace y vuelve a compilar.

En principio, debiera funcionar sin problemas. No obstante esto está sujeto a cambio, ya que funciona con la estructura del actual fichero .aar.