Dit document bevat instructies voor het installeren en configureren van Klukkluk V0.4 voor zowel Windows 10 & 11 als MacOS X Ventura. De applicatie wordt aangeleverd als zowel een executable .jar als een .msi installer.

Installatie Windows via klukkluk-0.4.msi

1. Download klukkluk-0.4.msi
2. Voer het bestand uit, dit opent een pop-up waarin gekozen kan worden waar de applicatie geïnstalleerd wordt.
3. 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 (Vereist Java 17 en JavaFX 17 SDK)

1. Download klukkluk-0.4.jar
2. Dubbelklik dit bestand om de applicatie op te starten.

In het geval dat dubbelklikken niet werkt, kan deze command-line in de Windows Opdrachtprompt uitgevoerd worden:

java -jar "<path-to-jar>\klukkluk-0.4.jar"

bijvoorbeeld:

java -jar "C:\Users\beheerder\Downloads\klukkluk-0.4.jar"

Installatie MacOS  X 10.5 of nieuwer (Vereist Java 17 en JavaFX 17 SDK)

Voor het gebruiken van Klukkluk V0.4 is Java 17 vereist, samen met de bijbehorende SDK van JavaFX

1. Download klukkluk-0.4.jar
2. 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.

Installeren Java

Klukkluk V0.4 is een Java applicatie, en is dus afhankelijk van Java op het systeem om te kunnen werken. Om Java op het systeem te configureren zijn een aantal stappen vereist:

Windows

1. Download de Java 17 SDK via Oracle (Noteer waar op het systeem deze staat)
2. Download de JavaFX 17 SDK via Gluon 
3. Druk op rechter muisklik op het Windows-logo en selecteer systeem, dit toont het volgende scherm:
4. Druk op Geavanceerde systeeminstellingen, het menu ziet er zo uit:
5. Druk rechtsonder op het net verschenen menu op Omgevingsvariabelen
6. Navigeer in de onderste tabel naar JAVA_HOME, druk op edit (Als deze nog niet bestaat, druk op new en maak de variabele aan)
7. Selecteer het bestandspad waar de Java SDK staat, bijvoorbeeld: 

   C:\Program Files\Java\jdk-17

8. Selecteer nu in de onderste tabel Path en druk op edit
9. Druk op new om een nieuwe variabele toe te voegen.
10. Selecteer het bestandspad waar de bin folder staat, bijvoorbeeld:

    %JAVA_HOME%\bin

11. Druk op Ok om weer terug te komen bij het menu Geavanceerde systeeminstellingen, klik op Toepassen
12. Controleer of Java juist geconfigureerd is door de Windows Opdrachtprompt te openen en het volgende commando uit te voeren:

    java -version

MacOS X 10.5 of nieuwer

1. Download de Java 17 SDK via Oracle
2. Download de JavaFX 17 SDK via Gluon
3. Open "~/.bash_profile" in een textbewerkingsprogramma
4. Voeg de volgende regel toe:

   export JAVA_HOME=$(/usr/libexec/java_home)

5. Sla het bestand op en sluit dit af
6. Open de terminal en voer het volgende commando uit om de wijzigingen toe te passen: 

   source ~/.bash_profile

7. Controleer of Java juist is geconfigureerd door het volgende commando in de Terminal uit te voeren:

   echo $JAVA_HOME