So wird die lokale Entwicklungsumgebung eingerichtet.

Systemvoraussetzungen #

git #

git installieren. Der Installationspfad von Git (C:\Program Files\git\bin) muss in der systemweiten PATH-Umgebungsvariable stehen.

Da das git-Protokoll von Firewalls geblockt werden kann, git so konfigurieren, dass stattdessen https verwendet wird:

# git config --global url.https://.insteadof git://

Ggf. müssen Proxy-Einstellungen gesetzt werden: in der normalen shell UND in der Admin-shell (git-shell als Admin ausführen).

# git config --global http.proxy <proxy-url:port>
# git config --global https.proxy <proxy-url:port>

Node.js #

Node.js installieren. Letzte als funktionierend bekannte Version: node-v10.15.0 mit NPM 6.4.1

Test in cmd:

# node -v

Mit Node.js wird auch der Node Package Manager NPM installiert.

Test in cmd:

# npm -v

npm lässt sich über die Kommandozeile konfigurieren. Konfig-Einträge werden je in die Dateien C:\Users<user>.npmrc geschrieben, die man auch direkt editieren kann. Übersicht über alle npm configs:

# npm config list
# npm config ls -l

Cache-Einstellungen #

npm legt einen Paket-Cache an. Per Default liegt der unter C:\Users<user>\AppData\Roaming\npm-cache. Das ist nicht gut, weil dieser Ordner beim An-/Abmelden synchronisiert wird. Daher den Pfad zum npm-cache außerhalb des Roaming-Profils setzen. Dazu die .npmrc-Dateien entsprechend anpassen oder in der cmd UND Admin-cmd (cmd als Admin ausführen):

npm config set cache D:\npm-cache

Proxy-Einstellungen #

in der normalen cmd UND in der Admin-cmd (cmd als Admin ausführen).

# npm config set proxy <proxy-url:port>
# npm config set https-proxy <proxy-url:port>

außerdem
# setx http_proxy <proxy-url:port>
# setx https_proxy <proxy-url:port>
--> danach alle cmds schließen und neu starten, damit die Änderungen wirksam werden

Die Proxies müssen ebenfalls in den Systemvariablen eingetragen werden.

npm-Pakete global als Admin installieren #

Einige npm-Pakete müssen in unserem Setup global und als Admin installiert werden, damit sie auf der Kommandozeile als normaler User ausführbar sind (wie normale Programme auch). Um das vorzubereiten in der Admin-cmd

# npm config set prefix C:\Programme\nodejs\

In diesen Pfad werden durch den Admin global installierte Pakete abgelegt. Doku zu npm-Ordnern.

ACHTUNG: Bitte VOR Konfiguration dieses Parameters den korrekten Systempfad ermitteln! (Auf einem deutschsprachigen Win10 ist dies bspw. C:\Program Files\nodejs)

Installation der Kartenviewer API #

Repository klonen und in das erstellte Verzeichnis wechseln:

# git clone https://git.geobasis-bb.de/open-data/kartenviewer-api/masterportal-fork.git

für alle npm-Pakete:

# npm update