Convertir ZIP en AAR

Une bibliothèque Android peut être distribuée sous forme de ZIP même si Android Studio ou Gradle nécessite une dépendance AAR. L’action requise consiste soit à reconstruire le projet de bibliothèque, soit à vérifier que le ZIP possède déjà la structure d’un AAR ; modifier .zip en .aar ne constitue normalement pas une conversion.

Qu’est-ce que le format ZIP ?

ZIP est un format d’archive polyvalent permettant de regrouper et de compresser des fichiers. Les développeurs l’utilisent pour les projets source Android, les packages SDK, les exemples de code, les fichiers compilés et les distributions finales ; Windows, macOS, Linux, 7-Zip et les systèmes de build peuvent le créer et l’extraire.

ZIP n’impose aucune structure de répertoires spécifique à Android. Inspectez l’archive avant de choisir une méthode de conversion : elle peut contenir un projet Gradle complet, une bibliothèque déjà empaquetée, des fichiers source ou des fichiers sans rapport.

Qu’est-ce que le format AAR ?

AAR, ou Android Archive, est le format de package produit pour un module de bibliothèque Android. Android Gradle Plugin et Android Studio peuvent l’utiliser comme dépendance locale, et un dépôt Maven peut le distribuer avec ses métadonnées associées.

Un AAR est techniquement un fichier ZIP possédant la structure d’une bibliothèque Android. Un AAR normal contient AndroidManifest.xml, classes.jar, res/ et R.txt ; il peut également contenir assets/, jni/, libs/, prefab/, public.txt, proguard.txt, lint.jar et d’autres entrées prises en charge. Il peut empaqueter du bytecode Java ou Kotlin compilé, des ressources Android, des déclarations de manifeste, des bibliothèques natives ainsi que des règles R8 ou ProGuard destinées aux consommateurs. Contrairement à un simple JAR, il peut contenir des ressources Android et des composants natifs.

Comment convertir un ZIP contenant un projet de bibliothèque

1. Extrayez le ZIP avec 7-Zip, l’utilitaire d’archivage du système ou Android Studio. Recherchez settings.gradle ou settings.gradle.kts, ainsi qu’un module contenant build.gradle ou build.gradle.kts.
2. Vérifiez que le module cible applique le plugin de bibliothèque Android, tel que com.android.library, plutôt que com.android.application. Ne transformez pas un module d’application en bibliothèque sans vérifier son manifeste, ses dépendances et sa configuration de build.
3. Ouvrez le projet extrait dans Android Studio, installez les versions du SDK et des build-tools demandées par le projet, puis laissez la synchronisation Gradle se terminer. Résolvez les dépôts, plugins et dépendances manquants avant la compilation.
4. Compilez la variante release depuis Android Studio avec Build → Make Project, ou exécutez la tâche du module depuis le répertoire du projet :

./gradlew :library:assembleRelease

Sous Windows, exécutez gradlew.bat :library:assembleRelease. Remplacez library par le nom réel du module. Le résultat se trouve normalement sous library/build/outputs/aar/, par exemple library-release.aar. Utilisez la tâche debug uniquement lorsqu’un AAR debug est spécifiquement requis.

Comment gérer un ZIP qui est déjà un AAR

Ouvrez l’archive avec 7-Zip ou un autre utilitaire d’archivage et inspectez son niveau supérieur. Si elle possède la structure d’un AAR, notamment AndroidManifest.xml, classes.jar, res/ et R.txt, son extension est peut-être incorrecte. Faites-en une copie et renommez-la :

mv library.zip library.aar

Sous Windows :

ren library.zip library.aar

Si les fichiers sont imbriqués dans un répertoire supplémentaire, réempaquetez le contenu afin que ces entrées se trouvent à la racine de l’archive. Le renommage ou le réempaquetage ne compile pas le code source, ne traite pas les ressources, ne génère pas R.txt et n’ajoute pas de manifeste. Testez l’AAR obtenu dans une petite application Android.

Comment gérer des fichiers source ou arbitraires

Un ZIP contenant uniquement des fichiers .java, .kt, .class, des documents ou des dossiers arbitraires ne peut pas être converti de manière fiable par un convertisseur d’archives. Créez ou ouvrez un module de bibliothèque Android, placez le code source sous src/main/java/ ou src/main/kotlin/, placez les ressources sous src/main/res/, placez les assets sous src/main/assets/, configurez le manifeste et les dépendances, puis exécutez assembleRelease.

Les fichiers natifs doivent utiliser les répertoires ABI attendus, tels que src/main/jniLibs/arm64-v8a/. Android Gradle Plugin doit compiler le code et les ressources ; un utilitaire ZIP général ne peut pas effectuer ces étapes.

Outils de bureau et en ligne

Android Studio avec Gradle est l’option de bureau appropriée lorsque le ZIP contient du code source ou un projet Gradle. 7-Zip, Finder, File Explorer et les commandes unzip ou zip en ligne de commande conviennent à l’inspection et au réempaquetage simple.

Les services d’archivage en ligne tels que CloudConvert ou Zamzar peuvent prendre en charge le réempaquetage générique de ZIP ou la conversion d’extension, mais ils ne peuvent pas résoudre les dépendances Android ni compiler un AAR. Utilisez un service en ligne uniquement pour une archive non confidentielle qui contient déjà le contenu AAR approprié ; ne téléversez pas de code source propriétaire, de SDK, de matériel de signature ou de bibliothèques privées.

Vérifications de compatibilité

Avant de distribuer le résultat, ouvrez l’AAR comme un ZIP et vérifiez son manifeste, classes.jar, ses ressources, ses bibliothèques natives, ses assets et ses règles destinées aux consommateurs. Testez-le avec l’Android Gradle Plugin, le compile SDK, la version de Kotlin et les ABI d’appareils prises en charge par le projet consommateur.

Un AAR n’intègre pas automatiquement toutes les dépendances Maven externes. Les consommateurs peuvent devoir déclarer ces dépendances séparément, et une dépendance de fichier local ne fournit pas les métadonnées de dépendances qu’offre une publication Maven. Ajoutez un AAR local avec une dépendance Gradle telle que implementation files('libs/library-release.aar'), ou publiez l’AAR dans un dépôt Maven avec son POM et ses métadonnées de module.