[[:oktatas:programozás:java|< Java]]

====== Java jar fájl készítése ======

  * **Szerző:** Sallai András
  * Copyright (c) 2011, Sallai András
  * Szerkesztve: 2011, 2015, 2023
  * Licenc: [[https://creativecommons.org/licenses/by-sa/4.0/|CC BY-SA 4.0]]
  * Web: https://szit.hu
===== A JAR fájlokról =====

A JAR fájlokat ezért hozzuk létre, hogy több állományban lévő osztályainkat egy "archív" fájlba rendezzük. 
Egy ilyen JAR fájl nem más, mint egy olyan ZIP állomány, amely java osztályokat és hozzájuk tartozó metaadatokat tartalmaz.

===== JAR fájl készítése =====



==== JAR kiindulási állományok ====


Legyen a példa kedvérét néhány osztály:
  * ProgramNev.class
  * ProgramNev$egyik.class
  * ProgramNev$masik.class
A főosztály a ProgramNev.class

Készítünk egy manifest.mf nevű fájlt a következő tartalommal:


<code java manifest.mf>
Main-Class: ProgramNev

</code>

**A ProgramNev után kell egy sortörés!**

==== Elkészítés ====

A főosztály nevét írjuk mindig a Main-Class: szöveg után.
<code bash>
jar cvfm ProgramNev.jar manifest.mf *.class
</code>

==== Futtatás ====

<code bash>
java -jar ProgramNev.jar
</code>

===== Megjegyzés =====

<code manifest menifest.mf>
Comment: Megjegyzés
X-COMMENT: Másik megjegyzés

</code>

===== Más jar fájlok használata =====
==== manifest fájl készítése ====


<code java manifest.mf>
Main-Class: ProgramNev
Class-Path: masikjarfile.jar harmadikjarfile.jar negyedikjarfile.jar

</code>

==== Elkészítés ====

Ugyanúgy készítjük el a JAR fájlt. 
<code bash>
jar cvfm ProgramNev.jar manifest.mf *.class
</code>

A plusz JAR fájlt nem tesszük a ProgramNev.jar fájlba.
Terjesztéskor csak mellé tesszük.

==== Közzétett fájlok ====

  * ProgramNev.jar
  * masikjarfile.jar
  * harmadikjarfile.jar
  * negyedikjarfile.jar
  * ProgramNev_Start.sh
  * ProgramNev_Start.bat

===== Több osztályból álló állományainkból jar fájl =====


Adott példaként a következő projekt:

<file>
CarRace
   |--controller
   |      |--Controller.java
   |
   |--view
   |    |--Car.java
   |    |--ButtonPanel.java
   |    |--DisplayPanel.java
   |    |--MainWindow.java
   |    |--Track.java
   |
   |--CarRace.java
   |--Makefile
</file>


Elkészítjük hozzá a megfelelő mainfest.mf fájlt:
<code manifest manifest.mf>
Main-Class: CarRace
Class-Path: controller/Controller view/Car view/ButtonPanel 
Class-Path: view/DisplayPanel view/MainWindow view/Track
</code>

Egy Makefile, amivel jar fájl is készíthető:
<code make Makefile>


SOURCES=CarRace.java \
	view/Car.java \
	view/MainWindow.java \
	view/Track.java \
	view/ButtonPanel.java \
	view/DisplayPanel.java \
	controller/Controller.java

all:
	javac $(SOURCES)

CLASSES=CarRace.class \
	view/*.class \
	controller/*.class

JARFILE=CarRace.jar
MANIFEST=manifest.mf

jar:
	jar cvfm $(JARFILE) $(MANIFEST) $(CLASSES)

run:
	java -jar $(JARFILE)

</code>

A jar fájlkészítő parancsnál ügyeljünk arra, hogy minden .class kiterjesztésű 
fájlt be kell építeni a jar fájlba.

A controller/ könyvtárban például a következő .class fájlok vannak:
  * Controller.class
  * Controller$1.class
  * Controller$2.class
  * Controller$3.class
  * Controller$4.class
  * Controller$5.class
  * Controller$6.class

Ezért "*" karaktert használok a Makefile-ban, hogy jelezzem az össze .class 
kiterjesztésű fájlra szükségem van.


===== Indító fájlok készítése =====


Lefordítjuk az osztályokat:
  javac *.class

Elkészítjük a jar fájlt:
  echo Main-Class: MyMainClassName > manifest.txt
  jar cvfm MyOwnJarfile.jar manifest.txt *.class

Elkészítjük a futtató scriptet ( .bat vagy .sh script)
  echo java -jar MyOwnJarfile.jar > start.bat

Ez után mehet az indítás.

===== Szimpla program ikonnal =====

<code>
Projekt01/
   |
   |--bin/
   |
   |--class/
   |   |
   |   |--Mainwindow.class
   |
   |--images/
   |    |
   |    |--projekt01Icon_32x32.png
   |
   |--src/
       |
       |--Mainwindow.java
       |
       |--Makefile
       |
       |--manifest.mf
</code>


<code make Makefile>

JFLAGS= -g
JC=javac
JVM=java
SRCS=Mainwindow.java
PROG=Projekt01
CLASSPATH=../class
JAR=jar
MANIFEST=manifest.mf
JARFLAGS=cvfm
BIN=../bin
RM=rm -f
 
all:
	$(JC) -Xlint:all -d $(CLASSPATH) $(SRCS)

run: $(SRCS)
	$(JVM) -cp ..:$(CLASSPATH) $(PROG)

clean:
	$(RM) $(CLASSPATH)/*.class
	$(RM) $(BIN)/*.jar
	$(RM) *.class

jar:
	$(JAR) $(JARFLAGS) $(BIN)/$(PROG).jar $(MANIFEST) -C $(CLASSPATH) .
	$(JAR) -uvf $(BIN)/$(PROG).jar ../images/projekt01Icon_32x32.png

</code>

===== MVC használata =====

<code>
projekt01
   |--classes/
   |    |
   |    |--controller/
   |    |    |--Controller.class
   |    |    `--MasController.class
   |    |--model/
   |    |   `--Model.class
   |    |--view/
   |    |    |--Mainwindow.class
   |    |    `--Masview.class
   |    `--Prog01.class
   |--src/
   `--manifest.mf
</code>


<code manifest manifest.fm>
Main-Class: Prog01
</code>

<code bash>
cd classes
jar cvfm ../tpgt.jar ../manifest.mf classes/
</code>


Ha Makefile-t írunk:

<code make>
jar:
    cd classes; jar cvfm ../tpgt.jar ../manifest.mf *
</code>

===== VSCode =====

A Visual Studio Code-ban nyissuk meg egy .java kiterjesztésű fájlt.
Megjelenik a Java projects nézet. Ott találunk egy jobbra mutató nyilat, talppal.

{{:oktatas:programozas:java:vscode_make_jar_jelolve.png?400|}}

Ugyanaz széthúzott oldalsávnál:

{{:oktatas:programozas:java:vscode_make_jar_szethuzva_jelolve.png?400|}}


Ki kell választanunk a main class-t:

{{:oktatas:programozas:java:vscode_make_jar_mainclass.png?400|}}

Meg kell mondanunk, mit szeretnénk beletenni:

{{:oktatas:programozas:java:vscode_make_jar_select-jar.png?400|}}

Az [ OK ] gombra kattintva, elkészül a projekt gyökérkönyvtárában a .jar fájl.