Konversi JAR menjadi JAD

Telepon dan emulator Java ME lama mungkin memerlukan deskriptor .jad untuk menginstal MIDlet .jar. Membuat deskriptor berguna ketika perangkat, portal operator, atau emulator tidak menerima JAR saja; deskriptor tidak mengemas ulang atau menggantikan aplikasi.

Apa itu format JAR

File JAR adalah arsip Java berbasis ZIP yang berisi class Java ME terkompilasi, resource aplikasi, dan biasanya META-INF/MANIFEST.MF. Lingkungan build Java ME mengemas MIDlet sebagai file JAR untuk telepon Nokia, Sony Ericsson, Samsung, dan telepon berkemampuan Java lainnya yang lebih lama, serta emulator.

JAR berisi class dan resource aplikasi. Mengganti nama arsip biasanya tidak mengubah isinya, tetapi mengedit atau mengompresnya kembali dapat membatalkan tanda tangan digital atau mengubah panjang byte yang tercatat dalam deskriptor yang sudah ada.

Apa itu format JAD

File JAD adalah Java Application Descriptor teks biasa yang terpisah. File ini berisi metadata instalasi, termasuk nama aplikasi, vendor, versi, class entry-point MIDlet, lokasi JAR, dan ukuran JAR.

Properti umum mencakup MIDlet-Name, MIDlet-Vendor, MIDlet-Version, MIDlet-1 (dan entri bernomor tambahan), MicroEdition-Profile, MicroEdition-Configuration, MIDlet-Jar-URL, dan MIDlet-Jar-Size. JAD memungkinkan installer Java ME membaca metadata dan, untuk instalasi over-the-air, menemukan JAR sebelum mengunduhnya.

JAD bukan file yang dapat dieksekusi dan tidak dapat menggantikan JAR. URL dapat berupa nama file relatif seperti Game.jar atau URL HTTP. Menyimpan Game.jad dan Game.jar bersama-sama dengan nama dasar yang sama merupakan pengaturan instalasi lokal yang paling kompatibel, tetapi namanya tidak selalu harus sama jika deskriptor menunjuk ke URL yang benar.

Cara membuat JAD dari JAR

Ini adalah tugas pembuatan metadata, bukan konversi biner. JAR asli tetap terpisah dan tidak berubah.

1. Buat cadangan JAR. Jika JAR ditandatangani, jangan memodifikasi, membongkar, atau mengompresnya kembali.
2. Gunakan generator JAD lokal seperti JADMaker, utilitas Windows lama yang dapat membaca manifest JAR dan membuat deskriptor dengan nama yang sama. Dapatkan dari arsip software tepercaya dan pindai unduhannya karena software ini tidak lagi dipelihara secara aktif.
3. Letakkan JAR di folder input utilitas atau buka melalui perintah file program tersebut. Buat deskriptor di folder yang sama, sehingga menghasilkan file seperti Game.jar dan Game.jad.
4. Buka JAD yang dihasilkan dalam editor teks biasa. Periksa apakah MIDlet-Jar-URL mengidentifikasi JAR yang sebenarnya dan apakah MIDlet-Jar-Size merupakan ukuran saat ini yang tepat dalam byte.
5. Salin atau perbaiki properti aplikasi menggunakan META-INF/MANIFEST.MF di dalam JAR sebagai referensi. Pastikan setiap class MIDlet-n ada di dalam arsip dan telepon target mendukung profile dan configuration Java ME yang dinyatakan.
6. Simpan file sebagai teks biasa dengan ekstensi .jad. Jangan biarkan editor teks menambahkan .txt. Untuk pasangan lokal, simpan kedua file dalam direktori yang sama jika URL-nya hanya Game.jar.

Java ME SDK dan build tool Java ME lama dapat menghasilkan JAD yang cocok saat mengemas project. Keduanya lebih disarankan jika source project tersedia, tetapi tidak selalu dapat merekonstruksi deskriptor asli dari setiap JAR sembarang. Perintah JDK jar tf Game.jar hanya mencantumkan isi arsip; perintah tersebut tidak membuat JAD lengkap.

Pembuatan manual dan pemeriksaan ukuran

Jika generator tidak tersedia, buka arsip dengan 7-Zip atau utilitas ZIP lainnya, periksa META-INF/MANIFEST.MF, lalu buat file teks yang berisi properti yang diperlukan. Contoh minimalnya adalah:

MIDlet-Name: Game
MIDlet-Vendor: Example
MIDlet-Version: 1.0
MIDlet-1: Game, /icon.png, com.example.Game
MicroEdition-Profile: MIDP-2.0
MicroEdition-Configuration: CLDC-1.1
MIDlet-Jar-URL: Game.jar
MIDlet-Jar-Size: 123456

Ganti nilai contoh dengan nilai yang didukung oleh aplikasi dan perangkat. Hitung panjang byte JAR yang tepat untuk didistribusikan:

• Linux: stat -c%s Game.jar
• macOS: stat -f%z Game.jar
• PowerShell: (Get-Item Game.jar).Length

Manifest dan JAD sering kali berisi properti yang tumpang tindih, tetapi keduanya merupakan file terpisah dan harus konsisten. Deskriptor yang dibuat sebelum JAR diganti atau dikompres ulang mungkin berisi ukuran yang sudah tidak berlaku dan harus dibuat ulang.

Kompatibilitas dan tool online

Konverter file online umum tidak sesuai untuk tugas ini: biasanya tool tersebut tidak dapat menyimpulkan deskriptor Java ME yang benar, dan mengunggah aplikasi proprietary atau yang ditandatangani akan mengekspos isinya. Generator JAD online dapat digunakan untuk JAR nonrahasia hanya jika secara eksplisit menghasilkan deskriptor Java ME; periksa setiap field dan jangan pernah menganggap output-nya sebagai sumber yang mutlak benar. Generator lokal atau editor teks lebih aman dan dapat bekerja tanpa mengunggah aplikasi.

Beberapa telepon menginstal JAR secara langsung, sementara yang lain memerlukan JAD atau mengharuskan JAD merujuk ke JAR yang dapat diakses melalui HTTP untuk instalasi over-the-air. Jika instalasi gagal, periksa URL yang tepat, ukuran byte, pasangan JAR/JAD, versi MIDP dan CLDC yang didukung, permission yang diperlukan, status sertifikat, dan ukuran JAR maksimum perangkat. Mengedit JAR yang ditandatangani akan merusak tanda tangannya; simpan arsip bertanda tangan asli dan ubah hanya deskriptor eksternal jika distribusi mengizinkannya.