Dit document bevat informatie die nodig is om aan de slag te gaan met verdere ontwikkeling van Klukkluk, en bevat instructies over het opzetten van de werkomgeving en informatie over libraries die gebruikt zijn om de applicatie te ontwikkelen.

Het klonen van de repository

De project-repository wordt door projectgroep ENIAC aangeleverd

Projectstructuur

De package-structuur van de applicatie staat beschreven in het SDD. Hiernaast bevat de repository nog een aantal extra bestanden waarmee verder gewerkt kan worden.

• CREATE.sql, het script waarmee de database aangemaakt kan worden. Mochten er ooit aanpassingen moeten plaatsvinden in de database, dan kunnen die via dit bestand ingevoerd worden. (Zorg er naderhand voor dat de Entity-klassen bijgewerkt worden)
• JaVaFo.jar, De externe library gebruikt voor de indelingen voor periodecompetities via zwitsers. Hierover later nog meer informatie.

JPA

tekst

module-info.java gebruiken

Klukkluk maakt gebruik van Java-modules. Deze worden gedefinieerd in het bestand module-info.java, waarin beschreven staat welke modules vereist zijn voor de werking van de applicatie, welke modules geopend worden, waarnaartoe deze worden geopend (indien toepasselijk) en welke modules geëxporteerd worden (en waarnaartoe indien van toepassing).

Voor versie 0.4 ziet het bestand er als volgt uit:

Bepaalde modules zijn verplicht naar de JavaFX module geëxporteerd te worden, zodat deze kunnen worden gebruikt met de JavaFX frontend, hierover later meer informatie.

Belangrijk, binnen de repository-klassen wordt gebruik gemaakt van Jakarta Persistence functies. Deze worden door IntelliJ rood aangegeven, IntelliJ wil deze immers van de jakarta.jakartaee.api module uitlezen. Deze functies worden al uitgelezen uit aanwezige modules. Het toevoegen van de jakarta.jakartaee.api module zorgt ervoor dat de applicatie niet zal builden.

JaVaFo

In het bestand zijn twee verschillende variaties van JaVaFo aanwezig. Welke van de twee van toepassing is hangt af van de manier waarop het project gepackaged wordt. Gedurende de ontwikkelingsperiode is gebruik gemaakt van online tooling om de codekwaliteit en stabiliteit van de builds te controleren, hiervoor moest JaVaFo in de system scope gedefinieerd worden, zodat de tooling deze via de Bitbucket repository kon inladen. Wanneer de applicatie via mvn package of mvn clean package wordt gepackaged dient gebruik te worden gemaakt van een local maven dependency.

Om de dependency lokaal te installeren dienen de instructies in de comments van module-info.java gevolgd te worden. Hierna kunnen de JaVaFo modules omgewisseld worden en kan in pom.xml de system scope en filepath uitgecomment worden. Voor een lokale maven dependency zijn deze immers niet van toepassing.

JavaFX

tekst

jpackage

Om de applicatie als een .msi te packagen kan gebruik worden gemaakt van jpackage. Jpackage werkt via een command line die in de Windows Command prompt of Terminal kan worden uitgevoerd. Dit ziet er als volgt uit:

jpackage --name Klukkluk --input "<path\to\main\jar\directory>" --type "msi" --app-version "0.4" --main-jar "klukkluk-0.x.jar" --win-dir-chooser --dest "<path\to\destination>" --win-shortcut --icon "<path\to\klukkluk.ico>"

Hierin zitten een aantal opties:

• --name: De naam van het bestand
• --input: Het absolute pad waar de te packagen .jar staat (alleen de .jar mag hierin staan!)
• --dest: Het absolute pad waar de het te maken bestand wordt opgeslagen. (Deze kan leeggelaten worden, het bestand wordt in dit geval in de input directory opgeslagen)
• --type: Het type bestand om te packagen (Let op: dit is OS-specifiek. Een MacOS systeem mag geen .exe of .msi packagen, en een Windows systeem mag geen .pkg of .dmg aanmaken!)
• --app-version: De versie van de applicatie
• --main-jar: de .jar die in het bestand verwerkt wordt
• --icon: Het absolute pad naar het bestand wat als icoon voor het programma gebruikt wordt

(Optioneel, OS-Specifiek)

• --win-dir-chooser: Geeft de gebruiker de mogelijkheid om te kiezen waar deze de applicatie wil installeren
• --win-shortcut: maakt een snelkoppeling aan op het bureaublad

Meer informatie over jpackage, samen met meer OS-specifieke opties, is te vinden in de documentatie van Oracle.