comparison INSTALL.markdown @ 948:c021d9a378d6

Script install dependencies.
author Tom Gottfried <tom@intevation.de>
date Thu, 29 Oct 2015 18:11:21 +0100
parents ee8837ad99f8
children 6fb23d793caa
comparison
equal deleted inserted replaced
947:ee8837ad99f8 948:c021d9a378d6
16 http://wald.intevation.org/projects/lada 16 http://wald.intevation.org/projects/lada
17 17
18 Die folgenden Hinweise beziehen sich auf die Installation und Einrichtung auf 18 Die folgenden Hinweise beziehen sich auf die Installation und Einrichtung auf
19 Basis eines Oracle-RedHat Linux Systems. 19 Basis eines Oracle-RedHat Linux Systems.
20 20
21 Der Lada-Client ist eine Anwendung die auf dem Framework ExtJs 4.2.1 basiert, 21 Der Lada-Client ist eine Anwendung die auf dem Framework ExtJs 4.2.1
22 Damit der Client funktioniert müssen Sie dieses Framework herunterladen und 22 (GPL-Version) basiert, welches mit `install-dependencies.sh` heruntergeladen
23 entpacken. Dies kann direkt in das root-Verzeichnis des Lada-Clients geschehen. 23 und installiert wird.
24 24
25 Für Applikationen die ebenfalls unter der GPL lizenziert wird - so wie der Lada
26 Client - kann ExtJs als [GPL Version heruntergeladen](http://cdn.sencha.com/ext/gpl/ext-4.2.1-gpl.zip)
27 werden.
28
29 Legen Sie nach dem Entpacken einen Symlink auf dieses Verzeichnis an:
30
31 ```
32 ln -s ext-4.2.1.883 extjs
33 ```
34 25
35 ### Kompilieren und Minifizieren der Anwendung 26 ### Kompilieren und Minifizieren der Anwendung
36 27
37 Zum Kompilieren der Anwendung kommt das Tool Sencha Cmd 4.0.x zum Einsatz. 28 Zum Kompilieren der Anwendung kommt das Tool Sencha Cmd 4.0.x zum Einsatz.
38 Mit Hilfe dieses Tools kann der Quellcode in eine einzelne Datei zusammengefasst 29 Mit Hilfe dieses Tools kann der Quellcode in eine einzelne Datei zusammengefasst
46 [Dokumentation von ExtJs](http://docs.sencha.com/extjs/4.2.1/#!/guide/command) 37 [Dokumentation von ExtJs](http://docs.sencha.com/extjs/4.2.1/#!/guide/command)
47 38
48 Zur Installation von Sencha Cmd werden Ruby und Java benötigt. 39 Zur Installation von Sencha Cmd werden Ruby und Java benötigt.
49 40
50 Bevor Sie die Anwendung kompilieren können, müssen Sie die im Abschnitt 41 Bevor Sie die Anwendung kompilieren können, müssen Sie die im Abschnitt
51 *Lizenzen und Bibliotheken* genannten Bibliotheken zum Projekt hinzufügen. 42 *Lizenzen und Bibliotheken* genannten Bibliotheken mit
43 `install-dependencies.sh` zum Projekt hinzufügen.
52 44
53 Um die Anwendung zu erzeugen und alle notwendigen Bibliotheken an den richtigen 45 Um die Anwendung zu erzeugen und alle notwendigen Bibliotheken an den richtigen
54 Platz zu legen, passen Sie den Pfad zu SenchaCMD in der Datei `build.sh` an und 46 Platz zu legen, passen Sie den Pfad zu SenchaCMD in der Datei `build.sh` an und
55 führen Sie das Shell-Skript aus. 47 führen Sie das Shell-Skript aus.
56
57
58 Das Verzeichnis `lada-client-VERSIONSNUMMER` enthält dann eine Datei `index.html` 48 Das Verzeichnis `lada-client-VERSIONSNUMMER` enthält dann eine Datei `index.html`
59 und eine Datei `lada.js`. Die Datei `lada.js` ist eine komprimierte Version der 49 und eine Datei `lada.js`. Die Datei `lada.js` ist eine komprimierte Version der
60 Anwendung und enthält alle benötigten Klassen. 50 Anwendung und enthält alle benötigten Klassen.
61 51
62 52
145 135
146 Der Lada-Client leitet in Zusammenarbeit mit dem Server automatisch an diesen weiter. 136 Der Lada-Client leitet in Zusammenarbeit mit dem Server automatisch an diesen weiter.
147 137
148 # Lizenzen und Bibliotheken 138 # Lizenzen und Bibliotheken
149 139
150 Die Anwendung verwendet mehrere Unterkomponenten, diese sind typischerweise im 140 Die Anwendung verwendet mehrere Unterkomponenten, die mit
151 Ordner `resources/lib` zu finden. 141 `install-dependencies.sh` in `resources/lib` installiert werden.
152 142
153 Folgende Bibliotheken werden neben ExtJs verwendet: 143 Folgende Bibliotheken werden neben ExtJs verwendet:
154 144
155 * Filesaver.js 145 * Filesaver.js
156 https://github.com/eligrey/FileSaver.js 146 https://github.com/eligrey/FileSaver.js
161 * Openlayers 2.13.1 151 * Openlayers 2.13.1
162 http://www.openlayers.org 152 http://www.openlayers.org
163 https://github.com/openlayers/openlayers 153 https://github.com/openlayers/openlayers
164 2-Clause BSD-License 154 2-Clause BSD-License
165 155
166 Diese sind im Ordner `resources/lib` zu finden, und werden in der `Index.html` 156 Diese werden in der `Index.html` referenziert.
167 referenziert.
168 157
169 Im Ordner resources/lib/ext befinden sich Bibliotheken die ExtJs ergänzen und in 158 In `resources/lib/ext` werden Bibliotheken installiert, die ExtJs
170 der Datei `app.js` aufgeführt werden. 159 ergänzen und in der Datei `app.js` aufgeführt werden:
171 160
172 * Ext.i18n.Bundle 0.3.3 (referenced as Ext.i18n in app.js) 161 * Ext.i18n.Bundle 0.3.3 (referenced as Ext.i18n in app.js)
173 https://github.com/elmasse/Ext.i18n.Bundle/tree/v0.3.3 162 https://github.com/elmasse/Ext.i18n.Bundle/tree/v0.3.3
174 MIT - License 163 MIT - License
175 * Ext.ux.upload 1.1.1 164 * Ext.ux.upload 1.1.1
176 https://github.com/ivan-novakov/extjs-upload-widget/tree/1.1.1 165 https://github.com/ivan-novakov/extjs-upload-widget/tree/1.1.1
177 3-Clause BSD-License 166 3-Clause BSD-License
178
179
180 ## Installation der Bibliotheken
181
182 Die aufgeführten Bibliotheken können über den Link zu Github als zip-Datei
183 heruntergeladen werden.
184
185 Dabei ist auf die korrekte Versionsnummer zu achten, falls dies in der Liste
186 oben angegeben wurde.
187
188 ```
189 cd /var/www/html/lada/resources/
190 mkdir lib/
191 cd lib
192 wget https://github.com/eligrey/FileSaver.js/archive/master.zip -O FileSaver-js.zip
193 wget https://github.com/eligrey/Blob.js/archive/master.zip -O Blob-js.zip
194 wget https://github.com/openlayers/openlayers/archive/release-2.13.1.zip -O OpenLayers-2-13-1.zip
195
196 mkdir ext
197 cd ext
198 wget https://github.com/elmasse/Ext.i18n.Bundle/archive/v0.3.3.zip -O Ext-i18n-Bundle-v0-3-3.zip
199 wget https://github.com/ivan-novakov/extjs-upload-widget/archive/1.1.1.zip -O Ext-ux-Upload-1-1-1.zip
200 ```
201
202 Die Dateien sind im Ordner `resources/lib/` zu entpacken
203
204 Um OpenLayers als "Single File" Version bereit zu haben, gehen Sie in das
205 Verzeichnis `build/resources/lib/OpenLayers` und führen Sie den folgenden Befehl
206 aus:
207
208 ```
209 python build.py
210 ```
211
212 Dies erstellt eine Datei `OpenLayers.js` innerhalb des Verzeichnisses.
213
214
215 ```
216 cd ..
217 unzip FileSaver-js.zip
218 unzip Blob-js.zip
219 unzip OpenLayers-2-13-1.zip
220
221 cd ext
222 unzip Ext-i18n-Bundle-v0-3-3.zip
223 unzip Ext-ux-Upload-1-1-1.zip
224 ```
225
226 Zum einfacheren Zugriff auf die Bibliothek, symbolische Links erstellen.
227 Dies ist praktisch wenn die Bibliothek ausgetauscht wird,
228 dann müssen die Quelltexte nicht angepasst werden
229
230 ```
231 cd ..
232 ln -s Blob.js-master Blob
233 ln -s FileSaver.js-master FileSaver
234 ln -s openlayers-release-2.13.1/build OpenLayers
235
236 cd ext
237 ln -s Ext.i18n.Bundle-0.3.3/i18n i18n
238 ln -s extjs-upload-widget-1.1.1/lib/upload upload
239 ```
240
241 Somit ist die Installation der Bibliotheken abgeschlossen.

http://lada.wald.intevation.org