Skip to content

BUILD.md

Latest commit

 

History

History
151 lines (101 loc) · 2.85 KB

BUILD.md

File metadata and controls

151 lines (101 loc) · 2.85 KB

Building MMapper

Overview

This guide describes how to build MMapper from source on Linux, macOS, and Windows using CMake and Ninja. For tested build configurations, see the GitHub Actions workflows.

Prerequisites

Ensure the following tools are installed:

  • A C++17-compatible compiler (e.g., GCC, Clang, MSVC)
  • CMake 3.20+
  • Ninja
  • Qt 6.2+ (6.5 recommended) with QtWebSockets

1. Get the Code

git clone https://github.com/MUME/MMapper.git
cd MMapper

2. Platform-Specific Setup

Linux (Debian/Ubuntu)

Install the required packages with:

sudo apt-get update
sudo apt-get install -y build-essential zlib1g-dev libssl-dev libglm-dev cmake ninja-build qt6-base-dev qt6-base-dev-tools libqt6opengl6-dev libqt6websockets6-dev qtkeychain-qt6-dev

After installing dependencies, build as usual:

mkdir build
cd build
cmake -G Ninja -DWITH_WEBSOCKET=ON -DWITH_QTKEYCHAIN=ON -S ..
cmake --build . --parallel

macOS

Install dependencies with Homebrew and aqtinstall:

brew install cmake ninja aqtinstall
aqt install-qt mac desktop 6.5.3 clang_64 -m qtwebsockets

Make sure Xcode Command Line Tools are installed:

xcode-select --install

Add Qt to your PATH:

echo 'export PATH="~/6.5.3/macos/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Then build:

mkdir build
cd build
cmake -G Ninja -DWITH_WEBSOCKET=ON -DWITH_QTKEYCHAIN=ON -S ..
cmake --build . --parallel

Windows

Install:

  • Python + pip install aqtinstall
  • CMake, Ninja, NSIS, 7-Zip
  • Visual Studio with Desktop development with C++

MSVC (Recommended)

aqt install-qt windows desktop 6.5.3 win64_msvc2019_64 -m qtwebsockets

Add Qt\6.5.3\msvc2019_64\bin to PATH.

MinGW (Alternative)

aqt install-qt windows desktop 6.5.3 win64_mingw -m qtwebsockets
aqt install-tool windows desktop tools_mingw1310

Add both Qt and MingW bin directories to PATH.

3. Build Instructions

From the project root:

mkdir build
cd build
cmake -G Ninja -DWITH_WEBSOCKET=ON -DWITH_QTKEYCHAIN=ON -S ..
cmake --build . --parallel

Optional: Run Tests

ctest

Optional: Create Package

cpack

Optional: Code Style Check

Run clang-format via Docker:

docker run --rm --platform linux/amd64 \
  -v "$(pwd):$(pwd)" -w "$(pwd)" \
  ghcr.io/jidicula/clang-format:14 \
  --dry-run --Werror --style=file \
  $(find src tests -iname '*.h' -o -iname '*.c' -o -iname '*.cpp' -o -iname '*.hpp')

CI Reference

Our GitHub Actions workflow defines the tested build environment across platforms.
If you're troubleshooting local issues, consider comparing your setup with the Docker images or tool versions used in CI.