Dit document bevat instructies voor het installeren en configureren van Klukkluk V0.4 voor zowel Windows als MacOS. De applicatie wordt aangeleverd als zowel een executable .jar als een .msi installer.
Installatie Windows via klukkluk-0.4.msi
- Download klukkluk-0.4.msi
- Voer het bestand uit, dit opent een pop-up waarin gekozen kan worden waar de applicatie geïnstalleerd wordt.
- Nadat de applicatie geïnstalleerd is verschijnt er een snelkoppeling op het bureaublad.
Voor deze manier van installeren is geen Java op het systeem vereist. Mocht dit toch een probleem opleveren staan later in dit document instructies voor het installeren en configureren van Java 17.
Installatie Windows via klukkluk-0.4.jar
- Download klukkluk-0.4.jar
- Dubbelklik dit bestand om de applicatie op te starten.
In het geval dat dubbelklikken niet werkt, kan deze command-line in de Windows Command Prompt uitgevoerd worden:
java -jar "<path-to-jar>\klukkluk-0.4.jar"
bijvoorbeeld:
java -jar "C:\Users\beheerder\Downloads\klukkluk-0.4.jar"
Installatie MacOS
Voor het gebruiken van Klukkluk V0.4 is Java 17 vereist, samen met de bijbehorende SDK van JavaFX
- Download klukkluk-0.4.jar
- Dubbelklik dit bestand om de applicatie op te starten.
In het geval dat dubbelklikken niet werkt, kan deze command-line in de console uitgevoerd worden:
java --module-path javafx-sdk-17.0.11/lib --add-modules javafx.fxml,javafx.controls -jar klukkluk-0.4.jar
Configuratie
Klukkluk V0.4 leest een aantal eigenschappen uit vanaf een speciaal bestand: klukkluk.properties, waaronder de locatie van de database en de gegevens voor de FTP client, die verbinding legt met de website van UVS. Hoewel dit bestand niet standaard aanwezig hoeft te zijn om het programma op te starten, wordt er wel vereist dat het op een specifiek pad op het systeem wordt opgeslagen om de gegevens uit te lezen. Dit pad is als volgt: <User home directory>/Documents/Klukkluk. Dit pad is hoofdlettergevoelig.
Op Windows zou dit pad er als volgt uitzien: C:\Users\beheerder\Documenten\Klukkluk
Mocht deze folder niet bestaan, dan dient deze door de gebruiker aangemaakt te worden.
De database (een bestand eindigend op .db) kan vanuit de applicatie geselecteerd worden, en kan vanuit overal op het systeem uitgelezen worden. De locatie kan binnen de applicatie door de gebruiker worden gekozen, en het gekozen pad wordt toegepast zodra de gebruiker de applicatie opnieuw opstart.