Skip to Content
Last modified by Tobias Wintrich on 2023/07/28 12:23
From version 15.1
edited by Tobias Wintrich
on 2023/07/28 08:53
Change comment: Neuen Anhang 02-Windows-Package-Builder.png hochladen
To version 21.1
edited by Tobias Wintrich
on 2023/07/28 12:23
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,12 +1,20 @@
1 1  = Softwarepakete für Windows mit dem Rangee Kommbox Package Builder =
2 2  
3 -Den Rangee Kommbox Package Builder für die Kommbox für Windows erhalten Sie auf Anfrage vom Rangee Support.
3 +In dieser Anleitung wird die Funktionsweise des Rangee Kommbox Package Builder für die Kommbox für Windows anhand eines Firefox Beispielmoduls erläutert.
4 4  
5 +Den Rangee Kommbox Package Builder erhalten Sie auf Anfrage über den Rangee Support.
6 +
7 += Vorbereitung =
8 +
9 +1. Stellen Sie die benötigten Dateien zur Softwareinstallation zusammen. In unserem Beispiel einen Firefox Full Installer in aktueller Version "Firefox Setup 115.0.3.exe"
10 +1. Machen Sie sich mit den benötigten Kommandozeilen Parametern für die unbeaufsichtigte (silent) Installation und Deinstallation ihres Programms vertraut. Bei Firefox sind dies:
11 +1*. **Installation**: Firefox Setup 115.0.3.exe **/S**
12 +1*. **Deinstallation**: %ProgramFiles%\Mozilla Firefox\uninstall\helper.exe" **/S**
13 +
5 5  == Metadaten ==
6 6  
7 7  Nach dem Starten der Anwendung ist der Tab „Metadaten“ automatisch geöffnet. Folgende Einstellungen können Sie dort vornehmen:
8 8  
9 -
10 10  (% class="wrapped" style="width:1280px" %)
11 11  |(% style="width:499px" %)(((
12 12  (% class="content-wrapper" %)
... ... @@ -13,47 +13,34 @@
13 13  (((
14 14  
15 15  
24 +[[image:01-Windows-Package-Builder.png||height="605" width="600"]]
16 16  
17 -{{lightbox image="pb1.png" group="1"/}}
18 -
19 19  //Erscheint in der Kommbox als Modul~://
20 20  
21 -//test 01 – win7es – build 001//
28 +**//Firefox 115.0.3-11.00 – win – build 002//**
22 22  )))
23 23  )))|(% style="width:777px" %)(((
24 -
31 +|**Option**|**Bedeutung**
32 +|**Paketname**|(((
33 +Frei Wählbar - Der in der Kommbox angezeigte Name Ihres Softwarepaketes. Es kann immer nur ein Softwarepaket mit gleichem namen gleichzeitig installiert sein.
25 25  
26 -**Paketname:**
35 +Hier: Firefox
36 +)))
37 +|**Paketversion**|(((
38 +Die in der Kommbox angezeigte Version. Diese kann zur Versionsangabe der Software oder zur internen Versionierung verwendet werden
27 27  
28 -Der in der Kommbox angezeigte Name Ihres Softwarepaketes.
40 +{{warning}}
41 +Über die Paketversion muss ebenfalls die Hauptversion der Kommbox definiert werden, für die dieses Paket geeignet ist (z.B.: 11.00)
42 +{{/warning}}
29 29  
30 -
31 -**Paketversion:**
32 -
33 -Die in der Kommbox angezeigte Version.
34 -
35 -
36 -**Buildnummer:**
37 -
38 -Die in der Kommbox angezeigte Buildnummer.
39 -
40 -
41 -**Zielfirmware:**
42 -
43 -Gibt die Firmwareversion an, für die das Paket gebaut wird. Für WES7 belassen Sie den Eintrag auf „win7es“.
44 -
45 -
46 -**Pakettyp:**
47 -
48 -Gibt an, ob es sich bei dem Paket um eine Software oder eine Firmware handelt. Belassen Sie den Eintrag auf Software.
49 -
50 -
51 -**Ausgabepfad:**
52 -
53 -In diesem Verzeichnis werden die Updatedateien für das Softwaremodul erstellt.
54 -
55 -
44 +Hier: //115.0.3-11.00 (Firefox Version + Kommbox Hauptversion)//
56 56  )))
46 +|**Buildnummer**|Die in der Kommbox angezeigte Buildnummer. Die Nummer kann wie die Paketversion zur internen Versionierung genutzt werden.
47 +|**Zielfirmware**|Gibt die Firmwareversion an, für die das Paket gebaut wird. Für alle Windows Kommbox ab 10.00 können Sie es aus //"win"// belassen
48 +|**Pakettyp**|Gibt an, ob es sich bei dem Paket um eine Software oder eine Firmware handelt. Belassen Sie den Eintrag auf Software.
49 +|**Erfordert Neustart**|Wenn gesetzt, wird nach der Installation ein Neustart durch die Kommbox durchgeführt
50 +|**Ausgabepfad**|In diesem Verzeichnis werden die Updatedateien für das Softwaremodul erstellt. Diese müssen auf ihren Updateserver übertragen werden
51 +)))
57 57  
58 58  == Dateien ==
59 59  
... ... @@ -63,48 +63,83 @@
63 63  |(((
64 64  (% class="content-wrapper" %)
65 65  (((
66 -{{lightbox image="pb2.png" group="1"/}}
61 +
67 67  )))
68 -)))|(((
63 +)))[[image:02-Windows-Package-Builder.png||height="605" width="600"]]|(((
69 69  
70 70  
71 71  
67 +|(% style="width:315px" %)Option|(% style="width:859px" %)Bedeutung
68 +|(% style="width:315px" %)**zu installierende Dateien und Ordner**|(% style="width:859px" %)(((
69 +Hier können Sie Dateien und Ordner ablegen, welche **dauerhaft **auf das Gerät übertragen werden sollen. Hierzu müssen Sie die **Quelle** auf Ihrem PC und das **Ziel **auf der Client-Seite definieren.
72 72  
71 +Bei Deinstallation des fertigen Softwaremoduls werden diese Dateien ebenfalls wieder entfernt.
73 73  
73 +In diesem Beispiel wird eine URL zu einer Intranet Seite auf den Öffentlichen Desktop auf Client-Seite übertragen
74 +)))
75 +|(% style="width:315px" %)**temporäre Dateien und Ordner**|(% style="width:859px" %)(((
76 +Hier können Sie Dateien und Ordner angeben, welche nur während der Installation benötigt werden.
74 74  
75 -Unter **„zu installierende Dateien und Ordner“ **geben Sie Dateien an, die 1 zu 1 auf den Client übertragen werden sollen. In dem Beispiel (links) wird ein Link zu einer Webseite auf den Desktop für alle Benutzer übertragen.
78 +In diesem Beispiel die Firefox Installationsdatei.
79 +)))
80 +)))
76 76  
82 += Registry =
77 77  
84 +Über den Tab „Registry“ kann ein beliebiger Registrierungswert auf dem Client gesetzt werden. In diesem Beispiel wird ein Schlüssel gesetzt der den Firefox bei jedem Start automatisch ausführt.
78 78  
86 +{{info}}
87 +Der Registrierungsschlüssel zum Autostart des Firefox Browser dient hier nur als Beispiel. Sollten Sie einen entsprechenden Anwendungsfall haben, empfehlen wir zum automatischen Start die in der Kommbox verfügbaren Verbindungstypen "Verknüpfung" oder "Skript" zu verwenden.
88 +{{/info}}
79 79  
90 +(% class="wikigeneratedid" %)
91 +[[image:03-Windows-Package-Builder.png||height="164" width="800"]]
80 80  
93 += Scripts =
81 81  
95 +Unter „Scripts“ kann ein Installations- und Deinstallationsskript erstellt werden. Es können alle Befehle der Windows Command Line (cmd) verwendet werden. Diese Scripts enthalten die komplette Logik zum Installieren und Deinstallieren Ihres Programms.
82 82  
97 +Zur Adressierung der **temporären Dateien und Ordner **steht Ihnen hier die Variable „**~_~_TempPath~_~_**“ zur Verfügung (Bitte beachten Sie Groß- und Kleinschreibung).
83 83  
84 -Unter **„temporäre Dateien und Ordner“** können Sie Dateien mitgeben, welche nur während der Installation benötigt werden. In diesem Beispiel ist es die aktuelle Firefox-Version, welche anschließend über den Tab „Scripte“ installiert wird.
99 +(% class="wrapped" %)
100 +|(%%)(% id="cke_bm_463274E" style="display:none" %) (% id="cke_bm_463275S" style="display:none" %) (%%) [[image:04-Windows-Package-Builder.png||height="506" width="600"]]|(((
101 +
85 85  
86 86  
87 -
104 +|(% style="width:315px" %)**Option**|(% style="width:859px" %)**Bedeutung**
105 +|(% style="width:315px" %)Installationsscript|(% style="width:859px" %)(((
106 +(((
107 +Hier können Sie untereinander beliebig viele Befehle ausführen welche für Ihre Installation Notwendig sind. Die Befehle werden bei erstmaliger Installation und bei jedem Update des Pakets (neue Paket/Buildnummer) ausgeführt.
88 88  )))
89 89  
90 -= Registry =
110 +(((
111 +{{warning}}
112 +Manche Programminstallationen führen nach einer unbeaufsichtigten Installation automatisch und ohne Rückfrage einen Neustart aus. Das sollte hier per Parameter unterbunden werden.
113 +Insofern die Anwendung nach Ihrer Installation einen Neustart benötigt, nutzen Sie bitte die entsprechende Option im Tab Metadaten
114 +{{/warning}}
91 91  
92 -Über den Tab „Registry“ kann ein beliebiger Registrierungswert auf dem Client gesetzt werden. In diesem Beispiel wird die „notepad.exe“ bei jeder Benutzeranmeldung ausgeführt.
116 +Hier: //"~_~_TempPath~_~_\Firefox Setup 115.0.3.exe" /S//
117 +)))
118 +)))
119 +|(% style="width:315px" %)Deinstallationscript|(% style="width:859px" %)(((
120 +(((
121 +Hier tragen Sie alle benötigten Befehle ein, welche zum entfernen Ihres Pakets benötigt werden. Die Befehle werden ausgeführt wenn Sie das Modul über die Kommbox wieder entfernen oder ein Update auf eine neuere Version des Moduls durchführen.
122 +)))
93 93  
94 -{{lightbox image="pb3.png" group="1"/}}
124 +(((
125 +In diesem Beispiel deinstallieren wir Firefox vom System und löschen den angelegten Registrierungsschlüssel wieder.
126 +)))
95 95  
96 -= Scripte =
128 +(((
129 +//%ProgramFiles%\Mozilla Firefox\uninstall\helper.exe /S//
130 +)))
97 97  
98 -Unter „Scripte“ kann ein Installations- und Deinstallationsscript mitgegeben. Es können alle der Windows Command Line (cmd) verwendet werden.
132 +(((
133 +//REG DELETE "HKEY_LOCAL_MACHINE\Microsoft\Windows\CurrentVersion\Run" /v autostartFirefox /f//
134 +)))
135 +)))
136 +)))
99 99  
100 -Das Installationsscript wird bei der Installation des Softwaremoduls ausgeführt. Das Deinstallationsscript sobald es wieder gelöscht wird.
101 -
102 -In folgendem Beispiel wird Firefox Silent mit Hilfe des Platzhalters „~_~_TempPath~_~_“ (Über diesen Platzhalter sind die temporären Dateien ansprechbar. Bitte beachten Sie Groß- und Kleinschreibung.) und dem Parameter -ms installiert.
103 -
104 -Unter Deinstallationsscript wird eine eventuell vorher installierte Version deinstalliert.
105 -
106 -{{lightbox image="pb4.png" group="1"/}}
107 -
108 108  = Menüs =
109 109  
110 110  Über das Menü {{status title="datei"/}}, kann das aktuelle Projekt gespeichert, ein anderes geladen oder ein neues angelegt werden.
... ... @@ -120,3 +120,7 @@
120 120  Öffnen Sie die Kommbox und navigieren Sie zu **{{status title="Setup"/}} -> {{status title="Software-Aktualisierung"/}}-> {{status title="Updateserver-Einstellungen"/}}. **Tragen Sie hier die Daten Ihres FTP- oder HTTP-Servers ein.
121 121  
122 122  Nachdem Sie diese Einstellungen übernommen haben, tauchen Ihre erstellten Module unter **{{status title="Verfügbare Pakete"/}} **zur Installation auf. Wählen Sie das zu installierende Paket und bestätigen Sie mit **{{status title="Übernehmen"/}}**. Nach einem anschließenden Neustart werden die Änderungen vorgenommen.
153 +
154 +[[image:05-Windows-Package-Builder.png||height="628" width="800"]]
155 +
156 +
03-Windows-Package-Builder.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.twintrich
Size
... ... @@ -1,0 +1,1 @@
1 +35.5 KB
Content
04-Windows-Package-Builder.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.twintrich
Size
... ... @@ -1,0 +1,1 @@
1 +37.1 KB
Content
05-Windows-Package-Builder.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.twintrich
Size
... ... @@ -1,0 +1,1 @@
1 +243.7 KB
Content