IntroductionA brief introduction to &kdesrc-build;What is &kdesrc-build;?
&kdesrc-build; is a script to help the &kde; community install &kde; software from its &git; source repositories,
and continue to update that software afterwards.
It is particularly intended to support those who need to supporting testing and
development of &kde; software, including users testing bugfixes and developers
working on new features.
The &kdesrc-build; script can be configured to maintain a single individual
module, a full &plasma; desktop with &kde; application set, or somewhere in between.
To get started, see , or continue reading for more
detail on how &kdesrc-build; works and what is covered in this documentation.
&kdesrc-build; operation in a nutshell&kdesrc-build; works by using the tools available to the user at the
command-line, using the same interfaces available to the user. When
&kdesrc-build; is run, the following sequence is followed: &kdesrc-build; reads in the command
line and configuration file, to
determine what to build, compile options to use, where to install,
&etc;&kdesrc-build; performs a source update for each module. The update continues until all modules
have been updated. Modules that fail to update normally do not stop the build
– you will be notified at the end which modules did not
update.Modules that were successfully updated are built, have their
test suite run, and are then installed. To reduce the overall time spent,
&kdesrc-build; will by default start building the code as soon as the first
module has completed updating, and allow the remaining updates to continue
behind the scenes.
A very good overview of how &kde; modules are
built, including informative diagrams, is provided on an online article discussing &kde;'s &krita; application. This
workflow is what &kdesrc-build; automates for all &kde; modules.
&intro-toc;