Package Builder

Package Builder
Grundidee
Anwendung konfigurieren
Anwendung starten
Ausführung

Grundidee

Vor Beginn eines Treffens werden von einem kleinen Team alle Rechner, auf denen RgZm laufen soll, entsprechend konfiguriert. Dabei werden neben der Konfigurationsdatei auch sämtliche BFO-Dateien kopiert.

An dieser Stelle ist es auch sinnvoll, immer die aktuellste stabile RgZm Version sowie eine für das Betriebssystem passende Java Laufzeitumgebung mitzukopieren.

Die Erstellung eines solchen Treffen Paketes, bei der man nur noch ein Skript ausführen muss und alle notwendigen Schritte werden automatisch durchgeführt, wird durch das nachfolgend dokumentierte Programmteil Package Builder realisiert.

Anwendung konfigurieren

Momentan ist die Anwendung noch auf das Terminal bzw. die Eingabeaufforderung beschränkt, daher muss beim Programmaufruf immer eine Konfigurationsdatei übergeben werden, dessen Format nachfolgend beschrieben wird.

Die Datei muss eine gültige JSON-Konfiguration wie nachstehend bereitstellen:

{
   "path":"/tmp/testPackage",
   "config":"./config/koemo13.rgzm",
   "bfo":"./fahrplan/Km13",
   "jres":["win_64","Win_32"]
}

Mittels

"path":"Ziel-Verzeichnispfad"

wird das Ausgabeverzeichnis angegeben. Wenn es nicht existiert wird es angelegt, dafür sind Schreibrechte erforderlich! Dieses Feld ist ein Pflichtfeld.

Per

"config":"Konfigurationsdatei"

ist eine Konfigurationsdatei inklusive Pfad anzugeben. Alternativ kann dies auch weggelassen werden.

Ähnlich verhält es sich mit

"bfo":"BFO-Verzeichnispfad"

nur das hier ein Verzeichnispfad angegeben werden muss, in dem sich sämtliche BFO Dateien befinden.

Es folgt die Auswahl der zu verwendenden Java Laufzeitumgebungen, die im Paket enthalten sein sollen, mittels

"jres":["JRE_1","JRE_2",...]

die im Zielordner in jeweilige Unterverzeichnisse komprimiert abgelegt werden. Folgende Werte sind zulässig, wobei Groß- und Kleinschreibung ignoriert wird:

Win_32 | Win_64 | Linux_32 | Linux_64 | Mac_64

Anwendung starten

Die Skripte dieser Anwendung befinden sich im Unterordner bin und können über die folgenden Kommandozeilenparameter konfiguriert werden: -c <configuration file> [-h] [-n] [-p <proxyHost:proxyPort>] [-q]

 -c,--config <configuration file>   Configuration file for package builder
 -h,--help                          Shows this help message
 -n,--no-gui                        Runs as cli application (default)
 -p,--proxy <proxyHost:proxyPort>   Sets or removes the user proxy
                                    settings
 -q,--quiet                         Quiet run without any output

Wichtigste Voraussetzung neben einer Konfigurationsdatei ist eine funktionierende Verbindung ins WWW!

MS Windows

Führe nun die Datei packagebuilder.bat aus, um die Anwendung zu starten.

Unix/Linux

Führe nun die Datei "packagebuilder" aus, um die Anwendung zu starten.

Beispiele

Startet das Programm unter Nutzung der angegebenen Konfigurationsdatei

packagebuilder -c config.pbr

Startet das Programm unter Nutzung der angegebenen Konfigurationsdatei und dem angegebenen Proxy (Proxy Einstellung wird gespeichert!)

packagebuilder -p localhost:8080 -c config.pbr

Löscht die benutzerdefinierten Proxy Einstellungen

packagebuilder -p " " -c " "

Ausführung

Ist eine Konfigurationsdatei übergeben worden und konnte diese erfolgreich eingelesen werden, werden zunächst die notwendigen URLs für den Download bereitgestellt und abgeglichen.

Anschließend wird der eigentliche Vorgang gestartet und ausführlich dokumentiert. Nach erfolgreichem Abschluss sind im angegebenen Zielverzeichnis sämtliche Dateien für die Paket-Installation abgespeichert. Je nach Auswahl des Betriebssystems sind folgende ausführbare Skriptdateien vorhanden:

buildApp => Linux/Unix
buildApp.cmd => Windows

English