2.1. Installation and initial configuration#

2.1.1. Initial Setup of KDE Builder#

Install uv utility with any way you prefer. See official documentation for available options.

You do not need to install python of any version, because uv will do it automatically inside the virtual environment.

Run the installation command:

uv tool install git+https://invent.kde.org/sdk/kde-builder.git

Make sure it works by running:

kde-builder --version

Add these cmake options to your config:

global:
  cmake-options ... -DPython3_FIND_VIRTUALENV=STANDARD -DPython3_FIND_UNVERSIONED_NAMES=FIRST

This will let cmake find python modules from your system packages.

KDE Builder uses a configuration file to control which projects are built, where they are installed to, etc.

Run this command to generate configuration file:

kde-builder --generate-config

The config file will be located at ~/.config/kde-builder.yaml (or $XDG_CONFIG_HOME/kde-builder.yaml, if $XDG_CONFIG_HOME is set).

You can then edit the ~/.config/kde-builder.yaml configuration file to make any changes you see fit.

Building of projects requires some packages from your distribution to be installed.

Run this command to install needed dependencies:

kde-builder --install-distro-packages