LinuxCommandLibrary

kde-builder

Build KDE software from source code

TLDR

Initialize kde-builder

$ kde-builder --initial-setup
copy

Compile a KDE component and its dependencies from the source (use workspace to compile Plasma desktop)
$ kde-builder [component_name1 component_name2 ...]
copy

Compile a component without updating its local code and without compiling its dependencies
$ kde-builder [[-SD|--no-src --no-include-dependencies]] [component_name]
copy

Refresh the build directories before compiling
$ kde-builder [[-r|--refresh-build]] [component_name]
copy

Resume compilation from a specific dependency
$ kde-builder [[-f|--resume-from]] [dependency_component] [component_name]
copy

Run a component with a specified executable name
$ kde-builder --run [executable_name]
copy

Install login session
$ kde-builder --install-login-session-only
copy

Use system libraries in place of a component if it fails to build
$ kde-builder --no-stop-on-failure [component_name]
copy

SYNOPSIS

kde-builder [options] [module ...]

PARAMETERS

--help
    Display usage information and exit.

--version
    Show version number and exit.

--build
    Build the specified modules (default).

--src-only
    Download sources only, no build.

--no-build
    Update sources but skip building.

--network
    Update modules from network repositories.

--include-dependencies
    Automatically build dependencies.

--pretend
    Show what would be done without executing.

--resume
    Resume a previously interrupted build.

--verbose
    Enable verbose output during build.

DESCRIPTION

kde-builder is a Perl-based tool designed for KDE developers to automate the process of downloading, compiling, and installing KDE software modules from source. It fetches the latest code from KDE's repositories, resolves dependencies, and builds specified modules or the entire KDE suite. Primarily used in the KDE3 and early KDE4 eras, it simplifies the development workflow by handling complex build configurations, patches, and updates.

Users configure it via a ~/.kde-builderrc file, specifying modules, repositories, and build options. It supports incremental builds, making it efficient for iterating on code changes. While powerful, it's command-line only and requires a properly set up development environment with Qt and necessary libraries.

CAVEATS

Deprecated tool; superseded by kdesrc-build. May not support modern KDE Gear/Plasma versions. Requires Perl and KDE devel packages.

CONFIGURATION

Edit ~/.kde-builderrc for modules list, global options, and repository mirrors.
Example:
global module-base-dir /home/user/kde/src

USAGE TIP

Run kde-builder --network to update all configured modules before building.

HISTORY

Originated in early 2000s for KDE 3.x development. Maintained through KDE4 transition until ~2009, when kdesrc-build (forked/enhanced version) took over for better Git integration and modularity.

SEE ALSO

kdesrc-build(1), cmake(1), make(1), qmake(1)

Copied to clipboard