Mercurial > lada > lada-client
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. |