From 0bdb112dcff891a85f076774f472a244c68dcbad Mon Sep 17 00:00:00 2001 From: ulrich Date: Fri, 22 Nov 2024 18:13:05 +0000 Subject: [PATCH] Buildscript angepasst --- README.md | 42 ++++++++++++++++++++++++++++++++++++------ 1 files changed, 36 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 674e2ed..608a90c 100644 --- a/README.md +++ b/README.md @@ -4,17 +4,47 @@ Weitere Informationen auf der [Produktseite](https://uhilger.de/data/pg/tango/). -## Abhängigkeiten +## Voraussetzungen -Tango nutzt und erfordert die folgenden Produkte: +Zur Herstellung von Tango aus dem Quellcode wird ein Java Development Kit (JDK) benötigt. Das JDK ist von [Adoptium](https://adoptium.net/) frei erhältlich. In der hier folgenden weiteren Beschreibung wird der lokale Ablageort des Java Development Kits `$JDK` genannt. -[Java](https://adoptopenjdk.net/) - Ablaufumgebung +Tango erfordert darüber hinaus die folgenden Klassenbibliotheken: + [Gson](https://github.com/google/gson) - JSON/Java Serialisierung und Deserialisierung [jID3Lib](http://javamusictag.sourceforge.net/) - Java ID3 Tag Library -[Mustache](http://mustache.github.io/) - "Logic-less templates." -[RobotoRegular](https://fonts.google.com/specimen/Roboto) - Schriftart -Die obigen Bestandteile sind bis auf das JDK im Auslieferungspaket enthalten. Im Falle der Verwendung des Quellcodes für eigene / andere Zwecke müssen diese allerdings selbst beschafft und hinzugefügt werden. +Die benötigten Klassenbibliotheken müssen zur Herstellung von Tango an einen Ablageort auf der lokalen Maschine heruntergeladen werden. Zudem werden auf der Seite des Clients folgende Hilfsmittel eingesetzt: + +[Mustache](http://mustache.github.io/) - "Logic-less templates." +[Roboto](https://fonts.google.com/specimen/Roboto) - Schriftart + +Mustache und Roboto sind im Quellcode von Tango in den Ordnern `www/font` und `www/js/mustache` hinterlegt. + +## Quellcode von Tango erhalten + +Der Quellcode von Tango wird von hier an einen frei wählbaren lokalen Ablageort heruntergeladen und entpackt. In der hier folgenden weiteren Beschreibung wird das so entstandene Verzeichnis `tango` einschließlich des absoluten Pfades dorthin `$TANGO` genannt. Anstelle von `$TANGO` würde man also beispielweise `/home/fred/tango` notieren, wenn in das persönliche Verzeichnis des Benutzers `fred` heruntergealden und entpackt wurde. + +## Tango herstellen + +Es wird angenommen, dass die als Abhängigkeiten aufgeführten Klassenbibliotheken lokal an einem Ort abgelegt sind, dessen Pfad mit dem Platzhalter `$JLIB` gemeint ist. Zur Herstellung von Tango werden mit Hilfe der wie zuvor beschrieben geladenen Teile die folgenden Kommandos ausgeführt (Beispiel für Linux): + +``` +cd $TANGO +mkdir classes +mkdir -p dist/lib +cp $JLIB/jid3lib-0.5.4.jar dist/lib +cp $JLIB/gson-2.8.6.jar dist/lib +cp src/*.properties classes +javac -classpath $JLIB/gson-2.8.6.jar:$JLIB/jid3lib-0.5.4.jar -d classes src/de/uhilger/tango/*.java src/de/uhilger/tango/api/*.java src/de/uhilger/tango/entity/*.java src/de/uhilger/tango/store/*.java +jar -cfm dist/tango.jar publish/manifest.mf -C classes . +cp -r www dist +``` + +Die fertig verwendbare Anwendung liegt anschließend unter `$TANGO/dist/tango.jar` mit den erforderlichen Klassenbibliotheken im Ordner `$TANGO/dist/lib` . + +## Tango verwenden + +Installation, Ausführung und Bedienung von Tango beschreibt die [Anleitung](https://uhilger.de/data/pg/tango/doku/anleitung.adoc). ## Lizenz -- Gitblit v1.9.3