Vorraussetzungen
- Node.js
- Nuclos MUSS im Entwicklungsmodus gestartet werden
Installation der benötigten Libraries
Folgender Befehl muss nicht bei jedem Start, sondern nur initial und nach Änderungen der verwendeten Bibliotheken (Datei: package.json) durchgeführt werden.
cd nuclos/nuclos-webclient npm install
df
npm install --save-dev eslint --verbose
Konfiguration des Nuclos-Servers
Die Server-Konfiguration wird mittels:
npm run config
erstellt.
Der Hostname, Port und Webcontextname des verwendeten Nuclos-Server muss anschließend über die Datei nuclos/nuclos-webclient/src/assets/config.json angepasst werden.
Starten des HTTP-Servers für den Webclient
node ./node_modules/@angular/cli/bin/ng serve --aot
Der Webclient ist dann über http://localhost:4200 erreichbar.
Mögliche Probleme beim Starten mit einem Addon
Es kann sein, dass die oben genannten Schritte in Verbindung mit einem Webaddon nicht funktionieren. Sollte dies der Fall sein, gibt es folgende Möglichkeiten um das Problem zu lösen:
- Löschen des Ordners node_modules und sicherstellen, dass keine anderen(unbekannten) Dateien des Webclients geändert wurden (ggf. mit einem VCS prüfen)
- npm install @nuclos/nuclos-addon-api
- npm run install-addon-deps
- npm install --save-exact @nuclos/nuclos-addon-api@latest rxjs@5.4.3 @nuclos/nuclos-addon-api@0.0.7
- npm install
Debuggen mit Chrome:
Um direkt in Chrom zu debuggen, muss man mit "Insprect" im Tab “Sources”, Untertab “Filesystem”, die TS-Sourcen (nuclos-webclient/src) mit “Add folder to workspace” angeben.
Der Chrome Debugger ist ausgezeichnet, sehr schnell und zuverlässig, weitaus besser als der IntelliJ Debugger. Einziger Nachteil: Zum persistenten Ändern der Sourcen sollte man die Stelle in IntelliJ suchen und dort Änderung. Zum schnellen Debuggen ist der Chrome Debugger zu empfehlen.
Mit Ctrl+P (Command+P beim Mac) kann man auch einzelne TS-Files öffnen, Breakpoints setzen.
Beispiel für Breakpoint in Zeile 17 von dashboard-grit-ite-wrapper.ts:
Überblick
Inhalte