Skip to content

Ubuntu HowTo

Jump to bottom Edit New page
wthaem edited this page Apr 23, 2021 · 11 revisions

Prev (Ubuntu-14.04) | Home | Manual | Index | (Linux Mint 19.x) Next

Table of contents

This installation guide is based on a fresh new installation of Ubuntu 18.04. It works with Ubuntu 20.04 LTS as well (tested with a virtual machine).

Changes for QMS versions newer than 1.15.2 and for PROJ version 8 are described here.

Check before you proceed:

Most modern versions of Debian including Ubuntu already have qmapshack in their repositories, no need to build for yourself.

~ ]$ apt-cache search qmapshack
qmapshack - GPS Kartierung (GeoTiff und Vector) und GPS-Verwaltung
~ ]$ sudo apt-get install qmapshack

Ubuntu build process

Initial build Routino and QMapShack

Create installation folder

Create an installation folder for all QMS data (ex. ~/GPS)

mkdir ~/GPS
cd ~/GPS

Installation of needed build packages

sudo apt-get install cmake build-essential subversion git \
qt5-default qttools5-dev libqt5webkit5-dev qtscript5-dev \
qttools5-dev-tools libgdal-dev libproj-dev libghc-bzlib-dev \
libgraphics-magick-perl libquazip5-dev libqt5sql5-mysql \
gdal-bin qtwebengine5-dev default-libmysqlclient-dev

Remarks:

  • Starting with version 1.13.0 QMapShack requires PROJ.4 version 5.0.0 or newer. It is reported that with the standard Ubuntu-20.04 installation this requirement is already fulfilled.

    To check the installed PROJ.4 version with the above command run

      pkg-config --modversion proj

    If necessary, an update of the PROJ.4 version can be done as follows:

  • Starting with version 1.15.0 QMapShack requires GDAL version 2.3 or newer. To check the installed GDAL installed run

      gdalinfo --version

    If necessary, an update of the GDAL version can be done as follows:

      sudo add-apt-repository ppa:ubuntugis/ppa
  sudo apt-get update
  sudo apt-get install gdal-bin

Initial build of Routino

svn co http://routino.org/svn/trunk routino
cd routino
make
sudo make install
cd ..

Note: If you see an error message when starting QMapShack stating something like ... routino lib not found ... maybe you have to modify Makefile.conf. Change line 48 from prefix=/usr/local to prefix=/usr and rerun the building steps of Routino.

Update of Routino when something has changed in future

cd ~/GPS/routino
svn update
make
sudo make install
cd

Initial build of QMapShack

git clone https://github.com/Maproom/qmapshack.git QMapShack
mkdir build_QMapShack
cd build_QMapShack
cmake ../QMapShack
make
sudo make install

Update of QMapShack when something has changed in future

cd ~/GPS/QMapShack
git pull
cd ../build_QMapShack
make
sudo make install
cd

Start QMapShack

qmapshack

Setup development environment

To code on your own, you can easily build a development environment by using "QtCreator" for coding.

sudo apt-get install qtcreator

Note: In QtCreator you can add -jN in Project/Create/Steps/Details/Toolparameter to speed up the compilation time. -jN specifies the number (N) of jobs to run simultaneously. You can start with -j2 and increase (-j3, -j4, ...) to the value of the optimal compilation speed depending on your CPU.

Depending on your version of qtcreator this parameter has to be set at: Projects/Build/Build Steps/Details/Tool arguments.

More information about developing of QMapShack will be found in chapter "Developing QMapShack" beginning here and here.

Prev (Ubuntu-14.04) | Home | Manual | Index | Top | (Linux Mint 19.x) Next

Add a custom footer

Recommended and most seen project pages

Clone this wiki locally