Ubuntu HowTo - Maproom/qmapshack GitHub Wiki

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

Table of contents

Ubuntu build process
- Initial build Routino and QMapShack
- Setup development environment

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:
- Ensure that SQLite3 is installed on your system.
- Download the source packages proj-5.x.0.tar.gz (or even proj-6.0.0.tar.gz) and proj-datumgrid-1.8.zip from the PROJ.4 download page.
- Follow the general installation instructions and the Autotools installation instructions.
- To install PROJ.4 at the correct location change to the PROJ.4 source folder and call
  
  ./configure --prefix=/usr make sudo make install
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.