Installation

Installation

Video-Anleitung

Das Video startet direkt beim Installationsabschnitt.

---

Systemvoraussetzungen

Um den Turnier-Manager reibungslos nutzen zu können, müssen folgende Voraussetzungen erfüllt sein:

• LibreOffice: ab Version 25.x (oder neuer)
• Java (JRE/JDK): ab Version 25
• Betriebssystem: Linux, Windows oder macOS 11 (Big Sur) oder neuer

---

Empfohlen: Installation mit dem Installer

Lade das passende Installer-Paket aus den GitHub Releases herunter:

• Linux: PetanqueTurnierManager-Installer-<version>-linux.AppImage
• Windows: PetanqueTurnierManager-Installer-<version>-windows.exe
• macOS (Apple Silicon, M1/M2/M3/…): PetanqueTurnierManager-Installer-<version>-macos-arm64.dmg
• macOS (Intel): PetanqueTurnierManager-Installer-<version>-macos-intel.dmg

Hinweis (macOS): Erfordert macOS 11 (Big Sur) oder neuer. macOS 10.15 (Catalina) und älter werden nicht unterstützt (Java-25-Laufzeit).

Starte den Installer und folge den Anweisungen. Der Installer richtet die Erweiterung für LibreOffice ein.

---

Alternative: Manuelle Installation

Die manuelle Einrichtung erfolgt in drei Schritten. Bitte achte darauf, dass die Architektur deiner Java-Version (32-Bit oder 64-Bit) zwingend mit deiner LibreOffice-Installation übereinstimmen muss.

Schritt 1: Java installieren

Falls noch kein Java installiert ist, lade eine aktuelle Version herunter und installiere sie. Wir empfehlen:

• Temurin Adoptium JDK (LTS): Kostenloser Download hier
• Oracle Java: Offizieller Download hier

Linux/Ubuntu – via SDKMAN (empfohlen für Entwickler):

curl -s "https://get.sdkman.io" | bash
sdk install java 25-tem

Linux/Ubuntu – via apt (Temurin):

# Adoptium-Repository einrichten (siehe https://adoptium.net/installation/linux/)
sudo apt-get install temurin-25-jdk
sudo apt-get install libreoffice-java-common

macOS – via SDKMAN:

curl -s "https://get.sdkman.io" | bash
sdk install java 25-tem

Windows-Hinweis: Die Bit-Version von Java muss zur Bit-Version von LibreOffice passen (beide 64-Bit oder beide 32-Bit). Fehlermeldung Could not create Java implementation loader → falsche Bit-Version. Details: https://newyear2006.wordpress.com/2018/08/12/beim-versuch-eine-libreoffice-erweiterung-hinzuzufgen-kommt-die-fehlermeldung-could-not-create-java-implementation-loader/

Schritt 2: Java in LibreOffice aktivieren

Damit LibreOffice die Erweiterung ausführen kann, muss die Java-Laufzeitumgebung verknüpft werden:

1. Öffne LibreOffice.
2. Navigiere in der Menüleiste zu: Extras ▸ Optionen ▸ LibreOffice ▸ Erweitert. (Unter macOS: LibreOffice ▸ Einstellungen...)
3. Setze unter der Überschrift „Java-Optionen“ ein Häkchen bei „Eine Java-Laufzeitumgebung verwenden“.
4. Wähle die installierte JRE aus der erscheinenden Liste aus. (Sollte die Liste leer sein, klicke auf „Hinzufügen“ und wähle den Ordner deiner Java-Installation manuell aus.)
5. Bestätige die Einstellungen mit OK und starte LibreOffice zur Sicherheit einmal neu.

Schritt 3: Die Erweiterung installieren

1. Lade die aktuellste Version der Erweiterung (Dateiname: PetanqueTurnierManager-vx.xx.oxt) aus dem Bereich Releases herunter.
2. Doppelklicke auf die .oxt-Datei. LibreOffice öffnet automatisch den Extension Manager und fragt nach der Installation.
3. Bestätige die Installation und akzeptiere (falls nötig) die Lizenzbedingungen.
4. Schließe den Extension Manager. Die Installation ist nun abgeschlossen!

Alternativ: Offizielle Anleitung zum Installieren einer Extension

---

LibreOffice installieren

Falls noch kein LibreOffice installiert ist:

• Windows: https://de.libreoffice.org/download/libreoffice-fresh/
• Linux/Ubuntu (aktuell via PPA):

  sudo add-apt-repository ppa:libreoffice/ppa
  sudo apt-get update
  sudo apt-get install libreoffice libreoffice-l10n-de libreoffice-help-de

• macOS: https://de.libreoffice.org/download/libreoffice-fresh/

---

Java in LibreOffice konfigurieren

Falls Java nicht automatisch erkannt wird: Extras → Optionen → LibreOffice → Erweitert → Java-Optionen Die installierte JRE/JDK auswählen und LibreOffice neu starten.