Starting point for the MapViewer extension workshop at the Tooling Days 2019.
This repository contains a docker container that provides ...
- Ubuntu 18.04 with Qt, GCC & NDS MVO 2019.4.0
- Control scripts to launch the container, and build a custom MapViewer extension inside of it.
Make sure that you have installed docker, and that you can run docker without sudo. Alternatively, run ./start-docker-env.sh with elevated privileges.
Just launch ./start-docker-env.sh. It will prompt you to enter Artifacotry credentials, and pull the pre-built container from NDS artifatory. If you want to rebuild the container yourself, just run docker build . in the folder that contains Dockerfile.
Hint for Windows Users: The
$PWDvariable used in the script is not working with Docker in the Git Shell. Just replace it with a path to this directory.
After the container has been pulled, it will drop you into a shell inside the container.
In your desktop environment, open a browser and connect to localhost:5000. You should receive a new MapViewerOnline Session hosted by the container.
The docker container will also host the extension API docs on port localhost:80!
Note, that the map configured as "map1" is intentionally left as a dummy - adjust mvo-cfg/mapviewerserver.json to add your own map!
Inside the container shell, just call ./update-mvo-ext.sh whenever you want to recompile. If compilation succeeds, you can simply reload your browser MVO session to see your updated extension at work!
After starting the container, a log file should be written under mapviewer.ext/log.txt. Inspect it inside the container with tail -f log.txt, or just view it from outside.