From 9ba48e8f393d5008709e2e7b42f69c470a97df10 Mon Sep 17 00:00:00 2001 From: Jon Eugster Date: Sun, 17 May 2026 20:09:11 +0200 Subject: [PATCH 1/4] doc: update docs for building on macos --- INSTALL.md | 43 ++++++++++++++++++++++++++++++++++++++----- 1 file changed, 38 insertions(+), 5 deletions(-) diff --git a/INSTALL.md b/INSTALL.md index d6f0b54be..6eb395bf8 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -6,9 +6,9 @@ The general build process prerequisites are: - A supported platform: - Linux. Ubuntu 18.04 is known to work. Linux is also used to cross-compile for Android. - - macOS: 10.13 is known to work. + - macOS: 10.13 is known to work, so is 26.3 (Tahoe). - Windows: MSYS2 (MinGW subsystem). - - CMake >= 3.7. + - CMake >= 3.7, < 4.0. CMake is available from https://cmake.org/. - A supported C++ compiler toolchain. C++14 is mandatory. @@ -17,7 +17,7 @@ components. Direct dependencies are: - Qt >=5.5 https://www.qt.io/download-open-source/ - Clipper library (aka libpolyclipping) >= 6.1.3a - http://www.angusj.com/delphi/clipper.php + http://www.angusj.com/delphi/ - PROJ Cartographic Projections Library >= 4.9 https://proj4.org/ - GDAL Geospatial Data Abstraction Library >= 2 @@ -77,11 +77,11 @@ zlib1g-dev ``` When not using Qt Creator, open a terminal, and create a build directory, e.g. -as subdirectory build in the source directory, and change to that directory. +as subdirectory build in the project's root directory, and change to that directory. From the build directory, configure and build like this: ``` -cmake PATH/TO/SOURCE_DIR +cmake PATH/TO/MAPPER_ROOT_DIR ``` When building on openSUSE, you may want to add -DMapper_BUILD_CLIPPER=1. This @@ -94,6 +94,39 @@ Now you may start the build process by running make ``` +## Compiling for macos (without OpenOrienteering superbuild) + +`brew` installs `cmake` 4.x but the project requires an older version 3. A legacy +version of `cmake` can be downloaded at https://cmake.org/download/#text=Legacy%20Release then located at +`/Applications/CMake.app/Contents/bin/cmake`. + +The remaining packages can be installed with `brew`: + +``` +brew install clipper2 proj gdal zlib qt@5 +``` + +Installed version at the writing of this section where + +``` +ยป brew list --versions clipper2 proj gdal zlib qt@5 +clipper2 2.0.1 +gdal 3.13.0 +proj 9.8.1 +qt@5 5.15.18 +zlib 1.3.2 +``` + +For the build it might be necessary to pass `-DCMAKE_PREFIX_PATH="$(brew --prefix qt@5)` to `cmake`: + +``` +mkdir build +cd build +cmake3 .. -DCMAKE_PREFIX_PATH="$(brew --prefix qt@5)" +make +``` + +The built application can then be opened with `open src/Mapper.app` ## Compiling for Windows (without OpenOrienteering superbuild) From b663649f551c5ab29149ef7fdc33bae900b0d404 Mon Sep 17 00:00:00 2001 From: Jon Eugster Date: Sun, 17 May 2026 22:52:57 +0200 Subject: [PATCH 2/4] Apply suggestion from @dg0yt Co-authored-by: Kai Pastor --- INSTALL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/INSTALL.md b/INSTALL.md index 6eb395bf8..154881d1b 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -94,7 +94,7 @@ Now you may start the build process by running make ``` -## Compiling for macos (without OpenOrienteering superbuild) +## Compiling for macOS (with brew instead of OpenOrienteering superbuild) `brew` installs `cmake` 4.x but the project requires an older version 3. A legacy version of `cmake` can be downloaded at https://cmake.org/download/#text=Legacy%20Release then located at From 60f1bb81114c837da9cfb936fe610a0b90e580ce Mon Sep 17 00:00:00 2001 From: Jon Eugster Date: Sun, 17 May 2026 23:06:55 +0200 Subject: [PATCH 3/4] review --- 3rd-party/clipper/CMakeLists.txt | 2 +- INSTALL.md | 18 +++++------------- 2 files changed, 6 insertions(+), 14 deletions(-) diff --git a/3rd-party/clipper/CMakeLists.txt b/3rd-party/clipper/CMakeLists.txt index 54021dc42..f756f9158 100644 --- a/3rd-party/clipper/CMakeLists.txt +++ b/3rd-party/clipper/CMakeLists.txt @@ -19,7 +19,7 @@ project(Clipper) -cmake_minimum_required(VERSION 2.8.3) +cmake_minimum_required(VERSION 3.7.0) # Configuration options diff --git a/INSTALL.md b/INSTALL.md index 154881d1b..2ce08a15d 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -8,7 +8,7 @@ The general build process prerequisites are: Linux is also used to cross-compile for Android. - macOS: 10.13 is known to work, so is 26.3 (Tahoe). - Windows: MSYS2 (MinGW subsystem). - - CMake >= 3.7, < 4.0. + - CMake >= 3.7. CMake is available from https://cmake.org/. - A supported C++ compiler toolchain. C++14 is mandatory. @@ -77,11 +77,11 @@ zlib1g-dev ``` When not using Qt Creator, open a terminal, and create a build directory, e.g. -as subdirectory build in the project's root directory, and change to that directory. +as subdirectory `build` in the source directory, and change to that directory. From the build directory, configure and build like this: ``` -cmake PATH/TO/MAPPER_ROOT_DIR +cmake PATH/TO/SOURCE_DIR ``` When building on openSUSE, you may want to add -DMapper_BUILD_CLIPPER=1. This @@ -96,11 +96,8 @@ make ## Compiling for macOS (with brew instead of OpenOrienteering superbuild) -`brew` installs `cmake` 4.x but the project requires an older version 3. A legacy -version of `cmake` can be downloaded at https://cmake.org/download/#text=Legacy%20Release then located at -`/Applications/CMake.app/Contents/bin/cmake`. -The remaining packages can be installed with `brew`: +The packages can be installed with `brew`: ``` brew install clipper2 proj gdal zlib qt@5 @@ -120,14 +117,9 @@ zlib 1.3.2 For the build it might be necessary to pass `-DCMAKE_PREFIX_PATH="$(brew --prefix qt@5)` to `cmake`: ``` -mkdir build -cd build -cmake3 .. -DCMAKE_PREFIX_PATH="$(brew --prefix qt@5)" -make +cmake .. -DCMAKE_PREFIX_PATH="$(brew --prefix qt@5)" ``` -The built application can then be opened with `open src/Mapper.app` - ## Compiling for Windows (without OpenOrienteering superbuild) A development environment on 64-bit Windows can be set up and maintained easily From 4a9d43c14619f021ff29f8db6d313bd18fd9f467 Mon Sep 17 00:00:00 2001 From: Jon Eugster Date: Mon, 18 May 2026 00:46:42 +0200 Subject: [PATCH 4/4] add link to brew --- INSTALL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/INSTALL.md b/INSTALL.md index 2ce08a15d..c7b04750c 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -97,7 +97,7 @@ make ## Compiling for macOS (with brew instead of OpenOrienteering superbuild) -The packages can be installed with `brew`: +The packages can be installed with `brew` (https://brew.sh): ``` brew install clipper2 proj gdal zlib qt@5