Development macOS

macOS development environment

This page is for building KLog from source for development. If you just want to run KLog, see Installation on macOS instead (the pre-built .dmg is simpler).

Requirements

• Qt6 (the official packaging scripts currently target Qt 6.10.2), installed via the Qt online installer under ~/Qt/<version>/macos, with Qt's own Ninja and CMake tools (~/Qt/Tools/Ninja, ~/Qt/Tools/CMake/CMake.app).
• Hamlib and its headers, for radio control support.
• Qt6 LinguistTools (lrelease) — required so translations are bundled into the app; if missing, the build will only ship English.

Build steps

1. Get the sources:

   git clone https://github.com/ea4k/klog.git
   cd klog
   

2. Configure with CMake, pointing CMAKE_PREFIX_PATH at your Qt installation:

   cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH="$HOME/Qt/6.10.2/macos"
   

3. Build:

   cmake --build build -j 4
   

   This produces build/bin/KLog.app.

4. Run it directly (open build/bin/KLog.app), or package it into a distributable .dmg with macdeployqt6:

   "$HOME/Qt/6.10.2/macos/bin/macdeployqt6" build/bin/KLog.app -qmldir=src/qml -codesign="-" -dmg
   

The repository's devscripts/macos-create-arm.sh and devscripts/macos-create-intel.sh scripts automate all of the above (clean, configure, build, verify translations, deploy Qt, and produce the .dmg) for Apple Silicon and Intel builds respectively — read through one of them for the exact, up-to-date reference commands.

See Development Notes for general contribution guidelines.