Converti ZIP in AAR

Una libreria Android può essere distribuita come ZIP anche se Android Studio o Gradle richiedono una dipendenza AAR. L’azione necessaria consiste nel ricostruire il progetto della libreria oppure verificare che lo ZIP abbia già la struttura AAR; modificare .zip in .aar normalmente non costituisce una conversione.

Che cos’è il formato ZIP

ZIP è un formato di archivio generico per raggruppare e comprimere file. Gli sviluppatori lo utilizzano per progetti sorgente Android, pacchetti SDK, codice di esempio, file compilati e distribuzioni di release; Windows, macOS, Linux, 7-Zip e i sistemi di build possono crearlo ed estrarlo.

ZIP non impone alcuna struttura di directory specifica per Android. Ispeziona l’archivio prima di scegliere un metodo di conversione: potrebbe contenere un progetto Gradle completo, una libreria già pacchettizzata, file sorgente oppure file non correlati.

Che cos’è il formato AAR

AAR, ovvero Android Archive, è il formato di pacchetto prodotto per un modulo di libreria Android. Android Gradle Plugin e Android Studio possono utilizzarlo come dipendenza locale, mentre un repository Maven può distribuirlo insieme ai relativi metadati.

Dal punto di vista tecnico, un AAR è un file ZIP con una struttura per librerie Android. Un AAR normale contiene AndroidManifest.xml, classes.jar, res/ e R.txt; può contenere anche assets/, jni/, libs/, prefab/, public.txt, proguard.txt, lint.jar e altre voci supportate. Può pacchettizzare bytecode Java o Kotlin compilato, risorse Android, dichiarazioni del manifest, librerie native e regole R8 o ProGuard per i consumer. A differenza di un semplice JAR, può contenere risorse Android e componenti nativi.

Come convertire uno ZIP contenente un progetto di libreria

1. Estrai lo ZIP con 7-Zip, l’utilità di archiviazione del sistema oppure Android Studio. Individua settings.gradle o settings.gradle.kts e un modulo contenente build.gradle o build.gradle.kts.
2. Verifica che il modulo di destinazione applichi il plugin per librerie Android, ad esempio com.android.library, invece di com.android.application. Non modificare un modulo application in una libreria senza controllare il relativo manifest, le dipendenze e la configurazione di build.
3. Apri il progetto estratto in Android Studio, installa le versioni di SDK e build-tools richieste dal progetto e consenti il completamento della sincronizzazione Gradle. Risolvi i repository, i plugin e le dipendenze mancanti prima della build.
4. Crea la variante release da Android Studio con Build → Make Project, oppure esegui il task del modulo dalla directory del progetto:

./gradlew :library:assembleRelease

Su Windows, esegui gradlew.bat :library:assembleRelease. Sostituisci library con il nome effettivo del modulo. L’output si trova normalmente in library/build/outputs/aar/, ad esempio library-release.aar. Usa il task debug solo quando è richiesto specificamente un AAR di debug.

Come gestire uno ZIP che è già un AAR

Apri l’archivio con 7-Zip o un’altra utilità di archiviazione e ispeziona il livello principale. Se presenta la struttura AAR, inclusi AndroidManifest.xml, classes.jar, res/ e R.txt, potrebbe avere l’estensione errata. Creane una copia e rinominala:

mv library.zip library.aar

Su Windows:

ren library.zip library.aar

Se i file sono annidati all’interno di una directory aggiuntiva, ricrea il pacchetto in modo che tali voci si trovino nella radice dell’archivio. Rinominare o ricreare il pacchetto non compila il codice sorgente, non elabora le risorse, non genera R.txt e non aggiunge un manifest. Testa l’AAR risultante in una piccola applicazione Android.

Come gestire file sorgente o arbitrari

Uno ZIP contenente solo .java, .kt, .class, documenti o cartelle arbitrarie non può essere convertito in modo affidabile da un convertitore di archivi. Crea o apri un modulo di libreria Android, inserisci il codice sorgente in src/main/java/ o src/main/kotlin/, inserisci le risorse in src/main/res/, inserisci gli asset in src/main/assets/, configura il manifest e le dipendenze ed esegui assembleRelease.

I file nativi devono utilizzare le directory ABI previste, ad esempio src/main/jniLibs/arm64-v8a/. Android Gradle Plugin deve compilare il codice e le risorse; un’utilità ZIP generica non può eseguire questi passaggi.

Strumenti desktop e online

Android Studio with Gradle è l’opzione desktop appropriata quando lo ZIP contiene codice sorgente o un progetto Gradle. 7-Zip, Finder, Esplora file e i comandi da riga di comando unzip o zip sono adatti per l’ispezione e la semplice ricreazione del pacchetto.

I servizi online per gli archivi, come CloudConvert o Zamzar, possono supportare la ricreazione generica di pacchetti ZIP o la conversione delle estensioni, ma non possono risolvere le dipendenze Android né creare un AAR. Utilizza un servizio online solo per un archivio non riservato che contenga già i contenuti AAR corretti; non caricare codice sorgente proprietario, SDK, materiale per la firma o librerie private.

Controlli di compatibilità

Prima di distribuire il risultato, apri l’AAR come ZIP e verifica il manifest, classes.jar, le risorse, le librerie native, gli asset e le regole per i consumer. Testalo con Android Gradle Plugin, compile SDK, versione Kotlin e ABI dei dispositivi supportati dal progetto che lo utilizzerà.

Un AAR non include automaticamente tutte le dipendenze Maven esterne. I consumer potrebbero dover dichiarare separatamente tali dipendenze, e una dipendenza da un file locale non fornisce i metadati delle dipendenze che una pubblicazione Maven mette a disposizione. Aggiungi un AAR locale con una dipendenza Gradle come implementation files('libs/library-release.aar'), oppure pubblica l’AAR in un repository Maven con il relativo POM e i metadati del modulo.