Převod souboru ZIP do JAR

Co je formát ZIP

ZIP je komprimovaný archiv pro obecné použití, který slouží ke sdružování souborů a složek pro stahování, sdílení, zálohování a ukládání. Windows File Explorer, macOS Archive Utility, správci archivů v Linuxu, 7-Zip, WinZip a vývojové nástroje vytvářejí soubory ZIP. ZIP může obsahovat zdrojový kód, dokumenty, obrázky, zkompilované třídy, knihovny nebo jiné archivy, ale nevyžaduje metadata specifická pro Java ani konkrétní strukturu adresářů.

Co je formát JAR

JAR neboli Java Archive je archiv založený na formátu ZIP pro Java třídy, prostředky, knihovny a aplikace. Může obsahovat META-INF/MANIFEST.MF, adresáře balíčků, soubory digitálních podpisů a obsah Java s podporou více vydání. Spustitelný JAR vyžaduje položku v manifestu, například Main-Class: com.example.Main, která umožňuje jeho spuštění pomocí java -jar. Java nástroje, build systems, application servers, mod loaders a plugin systems mohou vyžadovat příponu .jar, i když jsou soubory uvnitř kompatibilní s formátem ZIP.

Jak vytvořit nespustitelný JAR

1. Nainstalujte JDK pro příkaz jar nebo nainstalujte desktopový nástroj pro práci s archivy, například 7-Zip.
2. Rozbalte ZIP do dočasného adresáře. Nevkládejte původní ZIP do nového archivu.
3. Zkontrolujte strukturu rozbalených souborů. Pokud ZIP obsahuje jeden nepotřebný adresář nejvyšší úrovně, použijte pouze obsah tohoto adresáře, pokud přijímající software očekává soubory v kořenu JAR.
4. Otevřete terminál v nadřazeném adresáři rozbalené složky a spusťte jar --create --file output.jar -C extracted-folder .. Ve starších vydáních JDK použijte jar cf output.jar -C extracted-folder ..
5. Prohlédněte výsledek pomocí jar --list --file output.jar a ověřte, že cesty balíčků a prostředky jsou umístěny tam, kde je aplikace očekává.

V nástroji 7-Zip zvolte Extract to <folder>, otevřete rozbalenou složku, vyberte její obsah a zvolte 7-Zip → Add to archive. Jako formát archivu vyberte ZIP a poté přejmenujte výsledek z output.zip na output.jar pouze v případě, že cílový software potřebuje příponu JAR. Vznikne JAR kompatibilní se ZIP, ale nebude spustitelný ani nebude obsahovat metadata Java.

Jak vytvořit spustitelný JAR

1. Zkompilujte zdrojové soubory Java pomocí JDK. Zdrojový soubor, například Main.java, není spustitelný jen proto, že je umístěn v JAR.
2. Zachovejte cesty balíčků: třída deklarovaná jako package com.example; patří do umístění com/example/Main.class.
3. Vytvořte prostý textový soubor MANIFEST.MF obsahující Main-Class: com.example.Main a zakončený koncovým znakem nového řádku. Hodnota musí obsahovat název třídy, nikoli název zdrojového souboru, a nesmí obsahovat .class.
4. Vytvořte archiv pomocí jar --create --file app.jar --manifest MANIFEST.MF -C extracted-folder .. V novějších verzích JDK lze pomocí jar --create --file app.jar --main-class com.example.Main -C extracted-folder . nastavit tuto položku bez samostatného souboru manifestu.
5. Otestujte jej pomocí java -jar app.jar. Chybějící třída, nesprávná cesta balíčku, chybný manifest, chybějící závislost nebo nesprávný název hlavní třídy zabrání spuštění.

U projektů Maven nebo Gradle použijte sestavení projektu namísto přebalení libovolného ZIP: mvn package nebo gradle build může zkompilovat třídy a vytvořit požadovaný manifest. Běžný JAR automaticky neobsahuje externí závislosti; pokud je vyžadován samostatný JAR obsahující vše potřebné, použijte konfiguraci assembly nebo shading podporovanou projektem.

Online a desktopové nástroje

Nástroj JDK jar je nejspolehlivější volbou, protože zachovává konvence Java archivů a podporuje manifesty. 7-Zip je vhodný pro přebalování a kontrolu nespustitelných archivů. Pro konverzi prováděnou pouze v prohlížeči lze u necitlivých souborů použít archivní službu, například online konvertor od Aspose, ověřte však, že jeho aktuální seznam formátů výslovně nabízí výstup JAR. Nenahrávejte zdrojový kód, proprietární knihovny, podpisové klíče, přihlašovací údaje ani jiný citlivý obsah archivů.

Omezení kompatibility

Přejmenování ZIP nezkopiluje kód Java, nevytvoří manifest, nezmění cesty balíčků ani nepřidá závislosti. Opětovné sestavení obvykle zachová obsah souborů bez ztráty kvality, nastavení komprese, časová razítka, oprávnění, šifrování a metadata archivu se však mohou změnit. Šifrování ZIP není standardním požadavkem pro soubory JAR a zašifrovaný vstup nemusí přežít opětovné sestavení pomocí JDK.

Přebalení podepsaného JAR zneplatní jeho podpis, protože obsah archivu a metadata podpisu si již nebudou odpovídat. Zachovejte původní strukturu adresářů, po vytvoření archiv zkontrolujte a otestujte jej s přesnou verzí Java a přijímajícím softwarem, který jej bude používat.