Převod souboru JAR do JAD

Starší telefony a emulátory Java ME mohou k instalaci MIDletu .jar vyžadovat deskriptor .jad. Vytvoření deskriptoru je užitečné, když zařízení, portál operátora nebo emulátor nepřijme samotný JAR; aplikaci znovu nebalí ani nenahrazuje.

Co je formát JAR

Soubor JAR je archiv Java založený na formátu ZIP, který obsahuje zkompilované třídy Java ME, prostředky aplikace a obvykle také META-INF/MANIFEST.MF. Vývojová prostředí Java ME balí MIDlety jako soubory JAR pro starší telefony Nokia, Sony Ericsson, Samsung a další telefony s podporou Javy, stejně jako pro emulátory.

JAR obsahuje třídy aplikace a prostředky. Přejmenování archivu obvykle nezmění jeho obsah, ale úprava nebo opětovná komprese může zneplatnit digitální podpis nebo změnit délku v bajtech zaznamenanou v existujícím deskriptoru.

Co je formát JAD

Soubor JAD je samostatný textový Java Application Descriptor. Obsahuje metadata instalace včetně názvu aplikace, dodavatele, verze, tříd vstupních bodů MIDletu, umístění JAR a velikosti JAR.

Mezi běžné vlastnosti patří MIDlet-Name, MIDlet-Vendor, MIDlet-Version, MIDlet-1 (a další číslované položky), MicroEdition-Profile, MicroEdition-Configuration, MIDlet-Jar-URL a MIDlet-Jar-Size. JAD umožňuje instalačnímu programu Java ME načíst metadata a při instalaci over-the-air před stažením vyhledat JAR.

JAD není spustitelný a nemůže nahradit JAR. URL může být relativní název souboru, například Game.jar, nebo HTTP URL. Uchovávání souborů Game.jad a Game.jar společně se stejným základním názvem je nejkompatibilnější uspořádání pro místní instalaci, ale názvy se nemusí vždy shodovat, pokud deskriptor odkazuje na správné URL.

Jak vytvořit JAD z JAR

Jedná se o úlohu generování metadat, nikoli o binární konverzi. Původní JAR zůstává oddělený a nezměněný.

1. Vytvořte zálohu JAR. Pokud je podepsaný, neupravujte jej, nerozbalujte ani znovu nekomprimujte.
2. Použijte místní generátor JAD, například JADMaker, starý nástroj pro Windows, který dokáže načíst manifest JAR a vygenerovat deskriptor se stejným názvem. Získejte jej z důvěryhodného archivu software a stažený soubor zkontrolujte, protože již není aktivně udržován.
3. Umístěte JAR do vstupní složky nástroje nebo jej otevřete pomocí příkazu pro práci se soubory v programu. Vygenerujte deskriptor ve stejné složce; vzniknou například soubory Game.jar a Game.jad.
4. Otevřete vygenerovaný JAD v textovém editoru. Zkontrolujte, že MIDlet-Jar-URL identifikuje skutečný JAR a že MIDlet-Jar-Size obsahuje přesnou aktuální velikost v bajtech.
5. Zkopírujte nebo opravte vlastnosti aplikace podle souboru META-INF/MANIFEST.MF uvnitř JAR, který použijete jako referenci. Ověřte, že každá třída MIDlet-n v archivu existuje a že cílový telefon podporuje deklarovaný profil a konfiguraci Java ME.
6. Uložte soubor jako prostý text s příponou .jad. Nedovolte textovému editoru přidat .txt. U místní dvojice ponechte oba soubory ve stejném adresáři, pokud je URL pouze Game.jar.

SDK Java ME a starší nástroje pro sestavování Java ME dokážou při balení projektu vygenerovat odpovídající JAD. Pokud je k dispozici zdrojový projekt, jsou vhodnější, ale nedokážou spolehlivě zrekonstruovat původní deskriptor z každého libovolného JAR. Příkaz JDK jar tf Game.jar pouze vypíše obsah archivu; nevytvoří kompletní JAD.

Ruční vytvoření a kontrola velikosti

Pokud není k dispozici žádný generátor, otevřete archiv pomocí 7-Zip nebo jiného nástroje pro ZIP, prohlédněte si META-INF/MANIFEST.MF a vytvořte textový soubor obsahující požadované vlastnosti. Minimální příklad:

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

Nahraďte příkladové hodnoty hodnotami podporovanými aplikací a zařízením. Vypočítejte délku v bajtech přesného JAR, který distribuujete:

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

Manifest a JAD často obsahují překrývající se vlastnosti, ale jedná se o samostatné soubory a měly by být vzájemně shodné. Deskriptor vygenerovaný před nahrazením nebo opětovnou kompresí JAR může obsahovat zastaralou velikost a musí být vygenerován znovu.

Kompatibilita a online nástroje

Obecné online převaděče souborů nejsou pro tuto úlohu vhodné: obvykle nedokážou odvodit správný deskriptor Java ME a nahrání proprietární nebo podepsané aplikace zpřístupní její obsah. Online generátor JAD lze použít pro JAR bez důvěrných údajů pouze tehdy, pokud výslovně generuje deskriptory Java ME; zkontrolujte každé pole a jeho výstup nikdy nepovažujte za autoritativní. Místní generátor nebo textový editor je bezpečnější a funguje bez nahrávání aplikace.

Některé telefony instalují JAR přímo, zatímco jiné vyžadují JAD nebo vyžadují, aby JAD odkazoval na JAR dostupný přes HTTP pro instalaci over-the-air. Pokud instalace selže, zkontrolujte přesné URL, velikost v bajtech, dvojici JAR/JAD, podporované verze MIDP a CLDC, požadovaná oprávnění, stav certifikátu a maximální velikost JAR v zařízení. Úpravou podepsaného JAR dojde k porušení jeho podpisu; ponechte původní podepsaný archiv a upravujte pouze externí deskriptor, pokud to distribuce umožňuje.