cmake: initial commit adding CMake support

Based on original work by Rashad Kanavath in 2020 with pull request:
#289

This update introduces preliminary support for building and installing
GRASS GIS using CMake across multiple platforms, including Windows with
MSVS, Linux, and macOS. The installation can be performed using either
the traditional GRASS file structure or a structure that complies with
the Filesystem Hierarchy Standard (FHS).

Co-authored-by: Rashad Kanavath <[email protected]>
Co-authored-by: Markus Neteler <[email protected]>
Co-authored-by: Loïc Bartoletti <[email protected]>
Co-authored-by: Aaron Saw <[email protected]>
Co-authored-by: Nicklas Larsson <[email protected]>
Co-authored-by: Huidae Cho <[email protected]>
Co-authored-by: Mahesh Maddineni <[email protected]>
Co-authored-by: Kandel Nelson <[email protected]>
Co-authored-by: Edouard Choinière <[email protected]>

Author: 9 people

.github/workflows/cmake.yml

@@ -0,0 +1,91 @@
+---
+name: CMake
+
+on:
+    push:
+        paths-ignore:
+            - 'doc/**'
+        branches:
+            - main
+            - releasebranch_*
+    pull_request:
+        paths-ignore:
+            - 'doc/**'
+
+concurrency:
+    group: ${{ github.workflow }}-${{ github.head_ref || github.ref }}
+    cancel-in-progress: true
+
+env:
+    CMAKE_UNITY_BUILD: OFF
+
+permissions:
+    contents: read
+
+jobs:
+
+    build-cmake:
+        runs-on: ubuntu-22.04
+        env:
+            CMakeVersion: "3.16.0"
+        steps:
+            - name: Checkout GRASS
+              uses: actions/[email protected]
+            - name: Install CMake
+              run: |
+                cd ${GITHUB_WORKSPACE}
+                arch=$(uname -s)-$(uname -m)
+                wget https://github.com/Kitware/CMake/releases/download/v3.16.0/cmake-3.16.0-${arch}.tar.gz
+                tar xzf cmake-${{ env.CMakeVersion }}-${arch}.tar.gz
+                echo "CMAKE_DIR=$GITHUB_WORKSPACE/cmake-${{ env.CMakeVersion }}-${arch}/bin" >> $GITHUB_ENV
+                echo "$GITHUB_WORKSPACE/cmake-${{ env.CMakeVersion }}-${arch}/bin" >> $GITHUB_PATH
+            - run: |
+                cmake --version
+            - name: Install dependencies
+              run: |
+                sudo apt-get update -y
+                sudo apt-get install -y wget git gawk findutils ninja-build
+                xargs -a <(awk '! /^ *(#|$)/' ".github/workflows/apt.txt") -r -- \
+                    sudo apt-get install -y --no-install-recommends --no-install-suggests
+            - name: Print build environment variables
+              shell: bash -el {0}
+              run: |
+                printenv | sort
+                gcc --version
+                ldd --version
+            - name: Create installation directory
+              run: |
+                mkdir $HOME/install
+            - name: Configure
+              run: |
+                cmake ${CMAKE_OPTIONS} -S $GITHUB_WORKSPACE -B $GITHUB_WORKSPACE/build -G Ninja \
+                  -DCMAKE_C_FLAGS="-I/usr/include -I/usr/include/gdal" \
+                  -DCMAKE_CXX_FLAGS="-I/usr/include -I/usr/include/gdal" \
+                  -DCMAKE_INSTALL_PREFIX=$HOME/install -DWITH_NLS=OFF -DWITH_GUI=OFF -DWITH_DOCS=OFF
+            - name: Print CMakeCache.txt
+              shell: bash -el {0}
+              run: |
+                cat ${GITHUB_WORKSPACE}/build/CMakeCache.txt
+            - name: Build
+              run: |
+                cmake --build build --verbose -j$(nproc)
+            - name: Install
+              run: |
+                cmake --install $GITHUB_WORKSPACE/build --verbose
+            - name: Add the bin directory to PATH
+              run: |
+                echo "$HOME/install/bin" >> $GITHUB_PATH
+            - name: Print installed versions
+              if: always()
+              run: .github/workflows/print_versions.sh
+            - name: Test executing of the grass command
+              run: .github/workflows/test_simple.sh
+            - name: Run tests
+              run: .github/workflows/test_thorough.sh --config .gunittest.cfg --min-success 72
+            - name: Make HTML test report available
+              if: ${{ !cancelled() }}
+              uses: actions/upload-artifact@65c4c4a1ddee5b72f698fdd19549f0f0fb45cf08 # v4.6.0
+              with:
+                  name: testreport-CMake
+                  path: testreport
+                  retention-days: 3