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.

...

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 Command Prompt 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

...

java --module-path javafx<path-to-sdk-17.0.11javaFX-SDK>/lib --add-modules javafx.fxml,javafx.controls -jar <path-to-jar>/klukkluk-0.4.jar

Configuratie

...

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:Image Added
4. Druk op Geavanceerde systeeminstellingen, het menu ziet er zo uit:Image Added
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)Image Added
7. Selecteer het bestandspad waar de Java SDK staat, bijvoorbeeld: 

   Code Block
   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:

    Code Block
    %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:

    Code Block
    java -version

MacOS X 10.5 of nieuwer

Java

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

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

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

   Code Block
   source ~/.bash_profile

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

   Code Block
   echo $JAVA_HOME

JavaFX

1. Download de JavaFX 17 SDK via Gluon
2. Extract het gedownloade archief naar een bekende locatie
3. Gebruik de locatie van de /lib folder in de geinstalleerde JavaFX SDK bij het commando voor het lanceren van klukkluk