@wegenenverkeer/ng-kaart v6.0.1-0
AWV commons angular
Angular kaart component gebaseerd op open layers voor gebruik bij AWV.
Waar te vinden?
Deze component is gepubliceerd als @wegenenverkeer/ng-kaart
op NPM.
Hoe werkt het?
Dit project ambieert de implementatie van Angular Package Format v4.0.
Er is nog geen support voor een dergelijke packaging in Angular-CLI. We baseren ons op https://github.com/filipesilva/angular-quickstart-lib
Beperkingen
Deze component is enkel ontwikkeld om gebruikt te worden op Google Chrome. Om in Firefox te werken bijvoorbeeld zijn een aantal shims nodig. Zie ook de openlayers website.
Development
Deze component is gebaseerd op de source code van de kaartcomponent gebruikt door district center. Nog niet alle features van de oorspronkelijke component zijn geïmplementeerd. Gelieve voor noodzakelijke features een featurerequest in github aan te maken.
Code testen
Deze component library is voorzien van een test Angular app.
npm start
Deze is dan te bereiken via http://localhost:4220/
In src\testApp
kan je je module toevoegen en op de pagina plaatsen om zo door te testen.
Dit laat je ook toe om protractors te schrijven.
Tot slot vormt de source code van deze pagina de gebruiksaanwijzing van de componenten.
CORS requests
Locatiezoeker
Dit is nog niet getest sinds de refactoring
Dit doet CORS requests via een SSH tunnel:
Leg een SSH tunnel naar de apigateway van dev:
ssh -L 5100:apigateway.dev.awv.internal:80 management.apps.mow.vlaanderen.be
Zet chrome open zonder web security om dit te testen.
macos:
open -a Google\ Chrome --args --disable-web-security --user-data-dir
*nix:
chromium-browser --disable-web-security --user-data-dir
NosqlFs laag
Ook de NosqlFs laag demo maakt een verbinding met een server die niet op op localhost:4420 draait. CORS requestvalidatie afzetten is hier eveneens de oplossing.
Code style
De code style wordt automatisch afgedwongen via tslint + prettier. Deze is ingesteld dat de code wordt herschreven on commit, tenzij er brekende wijzigingen zijn (zoals foute typering en dergelijke meer).
Publish
We gebruiken travis-ci als CI tool. Travis wordt automatisch gestart bij een push naar github.
Vooraleer je aan een nieuwe feature/bug fix begint te werken, moet de versie in package.json
opgehoogd worden.
Dat doe je best door gebruik te maken van de betreffende npm commandos.
Dus bijv. om een nieuwe feature te starten:
npm version preminor
En wanneer de feature klaar is, en het is nog steeds maar een feature, doe dan:
npm version minor -m 'Release van %s: mijn feature naam'
TODO: een postversion hook maken die src/lib/package.json
in sync houdt.