BuildFedora - Maproom/qmapshack GitHub Wiki

Prev (Linux Mint 20.1) | Home | Manual | Index | (Ubuntu 24.04.3) Next

Table of contents

QMapShack installation for Fedora 44

Status

Installation from official Fedora repository

An official Fedora QMapshack package is available in the Fedora repository.

This is the preferred method for all users who only intend to use the latest official version of QMapShack.

sudo dnf install qmapshack

Note: As status of 2026-06-05 the official release is still V_1.17.1. Please give the package maintainer the time they need to update it to V_1.20.2.

Self compiling

Use it when:

  • The official QMapShack Fedora package is out of date
  • Or there is something wrong with the official QMapShack Fedora package
  • Or you would like to test or use the latest developments of QMapShack
  • Or you would like to code your own features

Installation of package dependencies

sudo dnf upgrade
sudo reboot

sudo dnf group install c-development development-tools
sudo dnf install cmake qt6-qtbase-devel qt6-qttools-devel qt6-qtwebengine-devel gdal-devel proj-devel bzip2-devel quazip-qt6-devel
sudo reboot

Compilation of Routino Version 3.4.3

See Routino Webpage

mkdir ~/GPS
cd ~/GPS
svn co http://routino.org/svn/trunk routino
cd routino
make -j$(nproc)
sudo make libdir=/usr/local/lib64 install
cd

Initial compilation

Based on the latest development commits, see QMapShack dev commits.

Clone repository

cd ~/GPS
git clone https://github.com/Maproom/qmapshack.git

Optional checkout

To build based on a dedicated tag, commit or branch.

cd qmapshack
git log
git checkout <tag | commit | branch>
cd ..

Examples for the git checkout

Compile based on tag

git checkout V_1.20.2

Compile based on dedicated commit, first 7 digits of hash are sufficient

git checkout 22bc04f

Compile based on latest commit from development branch dev

git checkout dev

Build and install

cd ~/GPS
mkdir build
cd build
cmake ../qmapshack
make -j$(nproc)
sudo make install
cd

Run QMapShack

Open terminal and enter qmapshack or to see debug messages qmapshack -d

Update compilation

Use it when there are new development commits available, see QMapShack dev commits.

cd ~/GPS/qmapshack
git pull

To checkout based on a dedicated tag, commit or branch, see above.

cd ../build
make -j$(nproc)
sudo make install
cd

Setup development environment using Qt Creator

Use it when:

  • You would like to extend QMapsShack by coding your own individual features
  • Or you would like to contribute code (bug fixing or new features) to QMapshack, see DeveloperCommitCode wiki page

Install Qt Creator

sudo dnf install qt-creator

Start Qt Creator by using the GUI or from terminal: qtcreator

Create project for QMapShack

The installation process for a QMapShack compilation should already have been carried out as described above.

Welcome > Projects > Open Project...

  • Open the file: ~/GPS/qmapshack/CMakeLists.txt

Configure two build configurations

  • Build configuration: Debug
    • Change Path to: ~/GPS/build_Desktop-Debug
  • Build configuration: Release with Debug Information
    • Change Path to: ~GPS/build_Desktop-RelWithDebInfo
  • Uncheck the build configurations that are not required
  • Configure

Setup for each build configuration

Projects > Build Settings

  • Section CMake
    • QML debugging and profiling: Disable
    • Filter Translation
      • Set UPDATE_TRANSLATION OFF
  • Section Build Steps
    • CMake arguments: j$(nproc) (or jn, for a specific number "n" of processor to use for compilation, ex. j4)

Projects > Run Settings

Command line arguments: -d

  • Section Debugger settings
    • QML debugger: Disable

Now you can code, build, test and debug, ...

Install in system environment

To install a release build into your system environment

cd ~/GPS/build_Desktop-RelWithDebInfo
make -j$(nproc)
sudo make install

Prev (Linux Mint 20.1) | Home | Manual | Index | Top | (Ubuntu 24.04.3) Next