Konversi ZIP menjadi AAR

Sebuah library Android dapat didistribusikan sebagai ZIP meskipun Android Studio atau Gradle memerlukan dependency AAR. Tindakan yang diperlukan adalah membangun ulang project library atau memastikan bahwa ZIP tersebut sudah memiliki layout AAR; mengubah .zip menjadi .aar biasanya bukan konversi.

Apa itu format ZIP

ZIP adalah format arsip serbaguna untuk menggabungkan dan mengompres file. Developer menggunakannya untuk project source Android, paket SDK, sample code, file terkompilasi, dan distribusi rilis; Windows, macOS, Linux, 7-Zip, serta build system dapat membuat dan mengekstraknya.

ZIP tidak menetapkan struktur direktori khusus Android. Periksa arsip sebelum memilih metode konversi: arsip tersebut mungkin berisi project Gradle lengkap, library yang sudah dikemas, source file, atau file yang tidak terkait.

Apa itu format AAR

AAR, atau Android Archive, adalah format paket yang dihasilkan untuk module library Android. Android Gradle Plugin dan Android Studio dapat menggunakannya sebagai local dependency, dan repository Maven dapat mendistribusikannya bersama metadata pendampingnya.

Secara teknis, AAR adalah file ZIP dengan layout library Android. AAR normal berisi AndroidManifest.xml, classes.jar, res/, dan R.txt; AAR juga dapat berisi assets/, jni/, libs/, prefab/, public.txt, proguard.txt, lint.jar, serta entry lain yang didukung. AAR dapat mengemas bytecode Java atau Kotlin yang telah dikompilasi, resource Android, deklarasi manifest, native library, serta consumer R8 atau ProGuard rules. Tidak seperti JAR biasa, AAR dapat membawa resource Android dan komponen native.

Cara mengonversi ZIP yang berisi project library

1. Ekstrak ZIP dengan 7-Zip, archive utility bawaan sistem, atau Android Studio. Temukan settings.gradle atau settings.gradle.kts dan sebuah module yang berisi build.gradle atau build.gradle.kts.
2. Pastikan module target menerapkan Android library plugin, seperti com.android.library, bukan com.android.application. Jangan mengubah application module menjadi library tanpa memeriksa manifest, dependencies, dan build configuration-nya.
3. Buka project yang telah diekstrak di Android Studio, instal versi SDK dan build-tools yang diminta oleh project, lalu biarkan sinkronisasi Gradle selesai. Selesaikan repository, plugin, dan dependency yang hilang sebelum melakukan build.
4. Build release variant dari Android Studio dengan Build → Make Project, atau jalankan module task dari direktori project:

./gradlew :library:assembleRelease

Di Windows, jalankan gradlew.bat :library:assembleRelease. Ganti library dengan nama module yang sebenarnya. Output biasanya berada di library/build/outputs/aar/, misalnya library-release.aar. Gunakan debug task hanya jika AAR debug memang diperlukan.

Cara menangani ZIP yang sebenarnya sudah berupa AAR

Buka arsip dengan 7-Zip atau archive utility lainnya dan periksa level teratasnya. Jika arsip tersebut memiliki struktur AAR, termasuk AndroidManifest.xml, classes.jar, res/, dan R.txt, mungkin arsip tersebut diberi ekstensi yang salah. Buat salinan lalu ubah namanya:

mv library.zip library.aar

Di Windows:

ren library.zip library.aar

Jika file berada di dalam direktori tambahan, kemas ulang isinya sehingga entry tersebut berada di root arsip. Mengubah nama atau mengemas ulang tidak akan mengompilasi source, memproses resource, menghasilkan R.txt, atau menambahkan manifest. Uji AAR yang dihasilkan dalam aplikasi Android kecil.

Cara menangani source atau file arbitrer

ZIP yang hanya berisi .java, .kt, .class, dokumen, atau folder arbitrer tidak dapat dikonversi secara andal menggunakan archive converter. Buat atau buka Android library module, tempatkan source di bawah src/main/java/ atau src/main/kotlin/, tempatkan resource di bawah src/main/res/, tempatkan asset di bawah src/main/assets/, konfigurasi manifest dan dependencies, lalu jalankan assembleRelease.

File native harus menggunakan direktori ABI yang diharapkan, seperti src/main/jniLibs/arm64-v8a/. Android Gradle Plugin harus mengompilasi code dan resource; ZIP utility umum tidak dapat melakukan langkah-langkah tersebut.

Tool desktop dan online

Android Studio dengan Gradle adalah opsi desktop yang sesuai ketika ZIP berisi source atau project Gradle. 7-Zip, Finder, File Explorer, serta unzip atau zip command-line sesuai untuk inspeksi dan pengemasan ulang sederhana.

Online archive service seperti CloudConvert atau Zamzar mungkin mendukung pengemasan ulang ZIP umum atau konversi ekstensi, tetapi tidak dapat menyelesaikan Android dependencies atau membangun AAR. Gunakan online service hanya untuk arsip non-rahasia yang sudah memiliki konten AAR yang benar; jangan upload source proprietary, SDK, signing material, atau library privat.

Pemeriksaan kompatibilitas

Sebelum mendistribusikan hasilnya, buka AAR sebagai ZIP dan verifikasi manifest, classes.jar, resource, native library, asset, serta consumer rules. Uji dengan Android Gradle Plugin, compile SDK, versi Kotlin, dan ABI perangkat yang didukung oleh consuming project.

AAR tidak secara otomatis menyertakan setiap external Maven dependency. Consumer mungkin perlu mendeklarasikan dependency tersebut secara terpisah, dan local file dependency tidak menyediakan dependency metadata yang diberikan oleh Maven publication. Tambahkan AAR lokal dengan Gradle dependency seperti implementation files('libs/library-release.aar'), atau publish AAR ke Maven repository bersama POM dan module metadata-nya.