Warning
This page is yet to be reviewed for changes required by the migration to Git. Information and commands on this page may no longer be valid and should be used with care. Please see the KDE Git hub page for more details.

Getting_Started/Build/KDE_Support

Building KDE4 From Source/KDE Support

Tutorial Series	Getting Started
Previous	Qt
What's Next	KDE Development Platform
Further Reading	n/a

Introduction

The KDE Support module contains a number of KDE developed and supported packages that the main KDE Modules depend upon. Your distribution packages may be sufficient for these requirements when building a KDE stable branch, but Unstable may sometimes require the latest versions to be built from source.

Most KDE Support packages have now migrated to Git as separate modules and must be built individually, although some are still left in Subversion and can be built as a single unit. The modules are listed below in a rough dependency order.

Required Steps

You need to have completed the following steps:

Set up your Build Environment
Selected your Build Recipes
Installed the System Requirements
Installed or Built Qt and related requirements
Understand the Requirements Table format

Requirements

The following table summarizes all the Projects contained in KDE Support and the versions required for building KDE Software. The optional/mandatory coloring is based on the requirements of the KDE Development Platform, the requirements for building other KDE Modules or Applications may vary.

**Build Requirements**
Requirement	Unstable Requires	Devel Pkgs?	Details
Automoc		No
Attica		Yes
Polkit Qt		Yes
Strigi		Yes
Soprano		Yes
Akonadi		Yes
Cagibi		Yes
Phonon		Yes
Prison	Any	Yes	A Qt based barcode library
Oxygen Icons		No
QImageBlitz		Yes
TagLib		Yes
cpp2xml		No

Template

Project is a

Project Page	http://projects.kde.org/projects/kdesupport/project
Stable Version
Required By
Easy Repository	git clone kde:project.git
Full Repository	git clone git://anongit.kde.org/project.git

**KDE Software Build Requirements**
Requirement	Stable Requires	Unstable Requires	Devel Pkgs?	Details
Project			Yes	A library

**Project Build Requirements**
Requirement	Stable Requires	Unstable Requires	Devel Pkgs?	Details
[http:// Project]			Yes	A library for

Automoc

Automoc is a tool to automate Qt moc file creation. Automoc MUST be built first as other KDE Support Modules depend on it.

Project Page	http://projects.kde.org/projects/kdesupport/automoc
Stable Version	0.9.88
Required By	All KDE Modules and Projects using moc
Easy Repository	git clone kde:automoc.git
Full Repository	git clone git://anongit.kde.org/automoc.git

**KDE Software Build Requirements**
Requirement	Stable Requires	Unstable Requires	Devel Pkgs?	Details
Automoc			No	A tool to automate Qt moc file creation.

Attica

Attica is a library for accessing the Open Collaboration Services.

Project Page	http://projects.kde.org/projects/kdesupport/attica
Stable Version	0.2.0
Required By
Easy Repository	git clone kde:attica.git
Full Repository	git clone git://anongit.kde.org/attica.git

**KDE Software Build Requirements**
Requirement	Stable Requires	Unstable Requires	Devel Pkgs?	Details
Attica			Yes	A library for accessing the Open Collaboration Services.

Polkit Qt

Polkit Qt is a library for accessing the PolicyKit authorization framework.

Project Page	http://projects.kde.org/projects/kdesupport/polkit-qt-1
Stable Version	0.99
Required By
Easy Repository	git clone kde:polkit-qt-1.git
Full Repository	git clone git://anongit.kde.org/polkit-qt-1.git

**KDE Software Build Requirements**
Requirement	Stable Requires	Unstable Requires	Devel Pkgs?	Details
PolKit Qt			Yes	A library for accessing the PolicyKit authorization framework.

**Polkit Qt Build Requirements**
Requirement	Stable Requires	Unstable Requires	Devel Pkgs?	Details
PolicyKit	>= 0.98	>= 0.98	Yes	The PolicyKit authorization framework. PolicyKit 0.98 is recommended, but Polkit Qt will build with any version.

Strigi

Strigi is a library for indexing files. Note that Strigi has now been split into a number of separate Git sub-projects, but these can still be cloned and built as a single entity using the Strigi parent project.

Project Page	http://projects.kde.org/projects/kdesupport/strigi
Stable Version	0.7.2
Required By
Easy Repository	git clone kde:strigi
Full Repository	git clone git://anongit.kde.org/strigi

Warning
As of 2011-03-21: After cloning the Strigi parent project, you will have to run the change_to_development_git.sh script to pull in all sub projects.

**KDE Software Build Requirements**
Requirement	Stable Requires	Unstable Requires	Devel Pkgs?	Details
Strigi			Yes	A library for indexing files.

**Project Build Requirements**
Requirement	Stable Requires	Unstable Requires	Devel Pkgs?	Details
Qt	>= 4.3.0	>= 4.3.0	Yes	The Qt development framework.
libz			Yes	A library for zip file compression
libbz2			Yes	A library for bzip2 file compression.
libxml2			Yes	A library for parsing XML
Clucene	>=0.9.16a	>=0.9.16a	Yes	A high-performance indexing and searching API. Version 0.9.17 does not work.
Exiv2			Yes	A library to manage image metadata.
FFMPEG			Yes	A library for reading audio and video files.
DBus			Yes	A message bus system.
FAM			Yes	A tool for file system monitoring.
Log4cxx			Yes	A logging framework for C++
CppUnit			Yes	A C++ Unit Testing framework

Soprano

Soprano is a library for storing RDF data for the Nepomuk semantic desktop.

Please see the Soprano project page for details.

Soprano must be built BEFORE Akonadi.

Easy:  git clone kde:soprano.git
Full:  git clone git://anongit.kde.org/soprano.git

Akonadi

Akonadi is a library for caching PIM data.

Please see the Akonadi project page for details.

Akonadi must be built AFTER Soprano.

Easy:  git clone kde:akonadi.git
Full:  git clone git://anongit.kde.org/akonadi.git

Cagibi

Cagibi is a cache/proxy daemon for SSDP, the discovery part of UPnP.

Please see the Cagibi project page for details.

Easy:  git clone kde:cagibi.git
Full:  git clone git://anongit.kde.org/cagibi.git

Phonon

Phonon is a sound system abstraction layer. This is usually packaged with Qt, but the Phonon version from Qt is not recent enough for KDE sound to work so you will need to build the required version yourself.

Please see the Phonon project page for details.

You need to install this Phonon in the same location as Phonon from Qt i.e. in $QTDIR and NOT in $KDEDIR.

Easy Recipe

This recipe assumes you have set up the recommended KDE scripts, environment variables, and git configuration.

cd <your source root directory>
git clone kde:phonon.git
cd phonon
cb
cmake $KDE_SRC/phonon
      \ -DCMAKE_INSTALL_PREFIX=$QTDIR 
      \ -DCMAKE_BUILD_TYPE=debugfull
      \ -DKDE4_BUILD_TESTS=TRUE
make
make install

Note that make install may require root access.

Full Recipe

This recipe assumes you are not using the recommended scripts and have properly set up your own environment.

cd <your source root directory>
git clone git://anongit.kde.org/phonon.git
cd <your build root directory, or the module source dir>
mkdir <your module build dir>
cd <your module build dir>
cmake <path to your module source dir>
      \ -DCMAKE_INSTALL_PREFIX=$QTDIR 
      \ -DCMAKE_BUILD_TYPE=debugfull
      \ -DKDE4_BUILD_TESTS=TRUE
make
make install

Backend

Building the main Phonon module is sufficient for building KDE. If you also want to play sound then you need to build a backend. Choose a suitable backend from those available below:

git clone git://anongit.kde.org/phonon-gstreamer.git
git clone git://anongit.kde.org/phonon-xine.git
git clone git://anongit.kde.org/phonon-directshow.git
git clone git://anongit.kde.org/phonon-mmf.git
git clone git://anongit.kde.org/phonon-quicktime.git
git clone git://anongit.kde.org/phonon-waveout.git

Note that DirectShow is for Windows only.

Troubleshooting

If you get an error like

designer: symbol lookup error: /path/to/kde/lib/kde4/plugins/phonon_backend/phonon_xine.so: 
          undefined symbol: _ZN6Phonon12PulseSupport11getInstanceEv

while running Qt Designer you need to:

rm $QTDIR/lib/libphonon.so.4

Prison

Prison is a barcode library to enable optional barcode support in KDE Software. It was introduced in the KDE 4.7 Release Cycle.

Project Page	http://projects.kde.org/projects/kdesupport/prison
Stable Version	Unreleased
Required By	No KDE Modules as yet
Easy Repository	git clone kde:prison.git
Full Repository	git clone git://anongit.kde.org/prison.git

**KDE Software Build Requirements**
Requirement	Stable Requires	Unstable Requires	Devel Pkgs?	Details
Prison		Any	Yes	A Qt based barcode library

**Prison Build Requirements**
Requirement	Stable Requires	Unstable Requires	Devel Pkgs?	Details
QRencode		Any	Yes	A library for reading and writing QR Code barcodes
Dmtx		Any	Yes	A library for reading and writing Data Matrix 2D barcodes

kdesupport svn module

A number of kdesupport packages are still in svn:

oxygen-icons
qimageblitz - for building kde-workspace
taglib
taglib-extras
cpp2xml
twine - for building kdebindings
emerge - for building kde on windows

These packages can be checked out and built together with a single recipe.

Note that QCA lives in kdesupport svn but is not built by default. It is recommended that you use your system QCA packages and only checkout the kdesupport svn version if you are going to develop QCA.

Easy Recipe

This recipe assumes you have set up the recommended KDE scripts, environment variables, and git configuration.

cd <your source root directory>
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

Full Recipe

This recipe assumes you are not using the recommended scripts and have properly set up your own environment.

cd <your source root directory>
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd <your build root directory, or the module source dir>
mkdir <your module build dir>
cd <your module build dir>
cmake <path to your module source dir>
      \ -DCMAKE_INSTALL_PREFIX=$KDEDIR 
      \ -DCMAKE_BUILD_TYPE=debugfull
      \ -DKDE4_BUILD_TESTS=TRUE
make 
make install

Troubleshooting

If you get a message related to

  target libQtTest.so not found

you may need to recompile qt-kde. This time you should take out

  -nomake demos -nomake examples

from the configure command, so that Qt generates library QtTest.

If you get

     CMake Error: Qt qmake not found!

Then:

     1) uncomment Qt section in .bashrc script (QTDIR, QT_PLUGINS_DIR,      
           PKG_CONFIG_PATH variable settings).
     2) source ~/.bashrc
     3) cd && cd qt-kde
     4) make confclean
     5) repeat steps for installing Qt (from ./configure line).
     6) retry building kdesupport

Next Step

Once all the KDE Support requirements have been installed it is time to install the KDE Development Platform

Getting Started/Build/KDE Support

Contents

Getting_Started/Build/KDE_Support

Introduction

Required Steps

Requirements

Template

Automoc

Attica

Polkit Qt

Strigi

Soprano

Akonadi

Cagibi

Phonon

Easy Recipe

Full Recipe

Backend

Troubleshooting

Prison

kdesupport svn module

Easy Recipe

Full Recipe

Troubleshooting

Next Step