BuildFedora - Maproom/qmapshack GitHub Wiki

Prev (Linux Mint 20.1) | Home | Manual | Index | (OSX) Next

Table of contents

QMapShack installation for Fedora 42

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 2025-07-06 the official release is still V_1.17.1. Please give the package maintainer the time they need to update it to V_1.18.0.

Self compiling

Use it when:

  • There is something wrong with the official QMapShack Fedora package
  • Or you would like to test or use the latest developments of QMapShack

Installation of needed packages

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

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 the repository

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

Optional checkout

To build based on a dedicated commit or tag.

cd qmapshack
git log
git checkout <tag or commit>
cd ..

Examples for the git checkout

Compile based on tag

git checkout V_1.18.0

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

git checkout 3bb32a7

Compile based on latest commit from development branch dev

git checkout dev

Build and install

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

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 commit or tag, see above.

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

Setup a 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 a project for QMapShack

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

Welcome > Open Project...

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

Configure Project > Set up two build environments

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

Setup for each build environment

Projects > Build & Run > Desktop > Build

  • 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)

Build & Run > Desktop > Run

  • Section Run
    • 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 | (OSX) Next