Konversi TGZ menjadi APK

Perangkat Android menerima APK, bukan TGZ, sehingga TGZ mungkin perlu diproses ketika aplikasi dikirim sebagai archive atau proyek Android harus menghasilkan package yang dapat diinstal. Operasi yang benar adalah ekstraksi dan, jika diperlukan, kompilasi; mengubah ekstensi filename tidak mengonversi file.

Apa itu format TGZ

TGZ adalah archive tar yang dikompresi dengan gzip, juga ditulis sebagai .tar.gz. Tool Unix dan Linux, repository source code, build system, dan workflow pengembangan Android menggunakannya untuk mengemas directory sambil mempertahankan path dan, jika didukung, permission.

TGZ dalam konteks mobile development mungkin berisi proyek Android Studio dengan settings.gradle atau settings.gradle.kts, file build Gradle, gradlew, AndroidManifest.xml, source code, resource, dan native library. TGZ tersebut juga mungkin berisi APK yang sudah jadi atau file yang tidak terkait. Ekstensi archive tidak mengidentifikasi isinya.

Apa itu format APK

APK adalah application package Android yang dapat diinstal. APK merupakan package berbasis ZIP yang berisi compiled application code, resource, manifest, native library opsional, dan data signing Android. Package manager Android memeriksa APK signature, permission yang diminta, persyaratan minimum dan target SDK, device policy, serta CPU architecture yang kompatibel sebelum instalasi.

APK adalah build output, bukan archive proyek Android. Android Gradle Plugin mengompilasi source dan resource, mengemasnya, lalu melakukan signing terhadap hasilnya. Oleh karena itu, archive yang berisi source code harus di-build; archive yang berisi APK yang sudah ada hanya perlu diekstrak. APK mendukung direct testing dan sideloading, termasuk instalasi offline, tetapi publikasi ke Play Store umumnya menggunakan Android App Bundle (.aab).

Cara memproses TGZ yang berisi APK

1. Ekstrak TGZ dengan desktop utility seperti 7-Zip atau PeaZip, atau dengan command line:

tar -xzf package.tgz -C extracted

2. Cari file yang berakhiran .apk di directory hasil ekstraksi. Periksa filename dan lokasinya untuk memilih variant yang diinginkan, seperti debug, release, atau build khusus perangkat.
3. Salin APK ke perangkat dan buka file tersebut, atau instal dengan Android Debug Bridge:

adb install path/to/app-release.apk

Aktifkan instalasi dari pengaturan unknown-source yang sesuai saat melakukan sideloading melalui file manager, dan jangan menginstal APK dari sumber yang tidak tepercaya. Jika package manager menolaknya, periksa signature, versi Android, CPU architecture, device policy, dan apakah instalasi lain dengan signing key yang berbeda sudah ada.

Pulihkan ekstensi .apk hanya jika file tersebut memang APK yang namanya telah diubah. TGZ adalah data TAR terkompresi gzip; mengganti namanya menjadi .apk tidak dapat membuatnya dapat diinstal. APK asli berbasis ZIP dan dapat dikenali melalui struktur filenya atau dengan membukanya menggunakan archive tool, tetapi penggantian nama saja tidak boleh digunakan untuk melewati security control.

Cara membangun APK dari proyek Android

1. Instal Android Studio, versi JDK yang diperlukan oleh Android Gradle Plugin proyek, dan komponen Android SDK yang dibutuhkan. Ekstrak TGZ ke directory yang dapat ditulis.
2. Buka proyek hasil ekstraksi di Android Studio dengan File → Open. Pilih directory yang berisi settings.gradle atau settings.gradle.kts, bukan file TGZ itu sendiri.
3. Biarkan sinkronisasi Gradle selesai. Instal SDK platform dan build tools yang diminta, lalu selesaikan dependency dari repository yang dideklarasikan oleh proyek. Proyek dengan source file yang hilang, private dependency yang tidak tersedia, atau versi Gradle dan plugin yang tidak kompatibel tidak dapat di-build tanpa modifikasi.
4. Untuk test build, pilih Build → Generate App Bundles or APKs → Generate APKs dan pilih module serta variant yang diperlukan. Android Studio biasanya menempatkan hasilnya di app/build/outputs/apk/, meskipun nama module dan product flavor dapat mengubah path tersebut.
5. Untuk distribusi, gunakan Build → Generate App Bundles or APKs → Generate Signed App Bundle or APK, pilih APK, dan lakukan signing terhadap release variant dengan private keystore. Simpan keystore dan password secara terpisah dari TGZ dan source repository.

Perintah Gradle yang setara, dijalankan dari directory proyek, adalah:

./gradlew assembleDebug
./gradlew assembleRelease

Di Windows, gunakan gradlew.bat assembleDebug atau gradlew.bat assembleRelease. Proyek dengan flavor mungkin memerlukan task seperti assembleFreeRelease; tampilkan task yang tersedia dengan ./gradlew tasks.

Pilihan tool online dan desktop

7-Zip dan PeaZip adalah extractor desktop yang sesuai untuk file TGZ. Android Studio dengan Gradle wrapper proyek merupakan local build tool yang sesuai; penggunaan wrapper mempertahankan versi Gradle yang diharapkan oleh proyek.

Tidak ada generic online TGZ-to-APK converter yang dapat diandalkan: web service tidak dapat menyimpulkan cara mengompilasi arbitrary source code, menyediakan private dependency, memilih versi SDK yang kompatibel, atau menghasilkan release signature dengan aman. Untuk cloud build, service berbasis repository seperti GitHub Actions atau Codemagic dapat menjalankan Gradle build proyek, tetapi konfigurasikan sendiri workflow, SDK, dependency, signing secret, dan artifact handling. Jangan upload proprietary source code atau keystore ke converter yang tidak terverifikasi.

Batasan kompatibilitas dan kualitas

TGZ yang berisi arbitrary file, Linux binary, source yang tidak lengkap, atau hanya Android library module tidak otomatis menghasilkan APK. Build yang berhasil tidak menjamin instalasi: package tersebut mungkin memerlukan Android release yang lebih baru, ABI yang tidak didukung, hardware yang tidak tersedia, permission yang diblokir oleh policy, atau signing key yang bertentangan dengan versi yang telah diinstal.

Debug APK ditandatangani dengan debug key dan ditujukan untuk testing. Release APK memerlukan controlled signing key, dan perubahan key tersebut mencegah update atas instalasi yang sudah ada dan ditandatangani oleh key asli. Jika proyek mendukung beberapa architecture atau versi Android, build variant yang sesuai atau gunakan konfigurasi packaging yang didokumentasikan oleh proyek.