spiegel-keyman/core/docs/api/building.md
Marc Durdin c78531dbc0 refactor(core): clean up API documentation
Move all Keyman Core header API documentation to javadoc-style so that
we can get inline documentation and simplify the readability of the
header files.

Update api-header-extractor to support minimal javadoc formatting of the
comments.

Test-bot: skip
2026-05-04 17:35:20 +02:00

7.3 KiB

title
How to build Keyman Core

Prerequisites

To build

  • Python 3
  • Meson build system.
  • C++17 or later compiler.

Optional

  • kmc (for testing)

Installing Python3

Linux

You will be able to install a python3 package in any reputable recent version of linux using its package manager if it's not already installed.

macOS

You can get the official installer from the official Python site: https://www.python.org/downloads/mac-osx

Windows

You can get the official installer from the official Python site: https://www.python.org/downloads/windows

Installing Meson

Ensure you have Python3 correctly installed and can run the command pip3.

$> python3 -m pip install meson

Building

In your source directory do the following:

$> cd core
$> ./build.sh configure build test

Note on kmc

kmc is node.js-based the command-line compiler from Keyman Developer, available from keyman.com or on npm at @keymanapp/kmc.

Windows

The search path can be edited through System settings / Advanced system settings / Environment Variables / User environment variables.

If you have Keyman Developer installed, kmc should already be on your path. Otherwise, add the path where you extracted the kmcomp archive.

Linux & MacOS

Install kmc from the NPM package.