Getting Started/Build/KDE4.x

Objectives

You probably want to keep your current KDE-3.5.x installation till you feel that KDE-4.x.y meets your needs for actual day to day use of your computer. Yet, you want to be able to change over with a minimum of work when the time comes to make the switch.

Method

The best way to accomplish this is to install the needed support libraries on your system in the usual manner. Convention is that these should be installed in the /usr/local/ directory. By default, Troll Tech installs Qt in: /usr/local/Trolltech/Qt-4/. It is best to install KDE-4.x.y in its own directory so that the directory can be deleted if some large problem occurs. I will be using /usr/local/KDE-4/ but you can call it whatever you want.

We will keep configurations straight by using a separate user account for accessing KDE-4.x.y. This user account will contain your configurations of KDE-4.x.y and will have a script to set the environment variables (.bash_profile if using Linux).

Installation

Required packages from your distribution

• Linux from Scratch or to build from source.

(Till other distro instructions are added, you can probably determine the correct version to install by reading the LFS list of libraries)

DO NOT build the Strigi version for KDE4 TRUNK for KDE-4.1

If you have trouble building 4.1.1 or 4.1 BRANCH >= r852727, use the Strigi-0.5.10 release NOT the Strigi-0.5 BRANCH >= 849001

DO NOT build the versions for KDE4 TRUNK for KDE-4.0

KDE-4.0: You need to have the correct versions for: Qt, Soprano, & QImageBlitz.

Create the User Account

Use whatever method you wish to create a new user account. Mine is called: "KDE4". Then edit or create the user specific login script (.bash_profile for Linux). There is a lot that goes into this. Note that this presumes that USER was correctly set by the system login script.

------8<------8<------8<------8<------8<------8<------8<------8<------8<------8<------8<------

# Redundant setting of HOME as work around for Bash bug

HOME=/home/KDE4

PATH=$HOME/bin:$PATH

export PATH HOME

XDG_DATA_HOME="$HOME/.local/share"

XDG_CONFIG_HOME="$HOME/.config"

export XDG_DATA_HOME XDG_CONFIG_HOME

KDEDIR=/usr/local/KDE-4

KDEHOME=$HOME/.kde4

KDETMP=/tmp/$USER-kde4

mkdir -p $KDETMP

KDEVARTMP=/var/tmp/$USER-kde4

mkdir -p $KDEVARTMP

KDEDIRS=$KDEDIR

PKG_CONFIG_PATH=/usr/local/KDE-4/lib/pkgconfig:$PKG_CONFIG_PATH

export KDEDIR KDEHOME KDETMP KDEVARTMP KDEDIRS PKG_CONFIG_PATH

QTDIR=/usr/local/Trolltech/Qt-4

QT_PLUGIN_PATH=$KDEDIR/lib/kde4/plugins:$QT_PLUGIN_PATH

PKG_CONFIG_PATH=$QTDIR/lib/pkgconfig:$PKG_CONFIG_PATH

export QTDIR QT_PLUGIN_PATH PKG_CONFIG_PATH

PATH=$QTDIR/bin:$KDEDIR/bin:$PATH

export PATH

XDG_CONFIG_DIRS=/usr/local/KDE-4/etc/xdg

XDG_DATA_DIRS=$KDEDIR/share

export XDG_CONFIG_DIRS XDG_DATA_DIRS

LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib

export LD_LIBRARY_PATH

LIBXCB_ALLOW_SLOPPY_LOCK="true"

export LIBXCB_ALLOW_SLOPPY_LOCK

------8<------8<------8<------8<------8<------8<------8<------8<------8<------8<------8<------

This is in addition to other things that you need in the script which would probably go at the beginning -- this large block of junk is to be added at the end. The XDG directories might need to be modified for your system.

Build

To build, you must be logged on as the new user account (KDE4). You can 'su' for the whole thing or 'su -C' for each install.

Packages need to be installed with the correct prefixes for this to work:

If you are building Qt from source, configure it with with --prefix=/usr/local/Trolltech/Qt-4. If you installed it from a binary, determine the prefix and change: QTDIR in the script above.

KDE should use: -DCMAKE_INSTALL_PREFIX=/usr/local/KDE-4 when running cmake.

KDE Support should installed in the same directory as KDE. This also applies to some of the packages if you are installing the individual packages/modules for a release or BRANCH. For packages that don't use CMake that would be: --prefix=/usr/local/KDE-4. The packages that don't install anything in "share" (eigen can be installed in "/usr/local/".

Other packages should be installed with the default prefix (/usr/local).