Umbrello Project • Project • Index

Installation

Install as Part of KDE Software Compilation

Umbrello is part of KDE Software Compilation which means it comes with all GNU/Linux distributions. You will be able to install it using your normal software installation app (Muon, Software Centre, Yast etc) or command line package manager (yum, up2date, yast, zypper, apt-get, emerge etc).

The package will be called umbrello, some older distros will package it as kdesdk.

Fedora

At least on fedora 20 it is also required to install the package oxygen-icon-theme, otherwise umbrello will not show any icons.

FreeBSD

Umbrello is available from FreeBSD ports.

Windows

Umbrello installer and portable packages for 32bit and 64 bit Windows are available at the KDE download mirror network.

Umbrello on Windows is also part of the KDE on Windows distribution installed with the KDE-Installer. Please note that the KDE on Windows distribution does not contain the latest umbrello releases.

Mac OS X

Umbrello is available for Mac OS X on MacPorts.

Source Code on Linux like operating systems

The program has no platform specific code code, so should compile on any system with KDE.

Here are the packages required for building Umbrello:

  • CMake
  • GNU make
  • GNU C++ compiler (g++)
  • libxslt, libxml2
  • Qt5/KF5
    • Qt >= 5.4, including development package
    • KDE frameworks development package 5.x
  • KDE4
    • Qt >= 4.7, including development package
    • kdelibs development package 4.8 or newer

To install from source out of git, enter the following commands in a shell:

mkdir -p $HOME/src
cd $HOME/src
git clone git://anongit.kde.org/umbrello  
cd umbrello
mkdir build
cd build

for building with Qt5/KF5 run:

cmake -DCMAKE_INSTALL_PREFIX=$HOME/umbrello -DBUILD_KF5=1 -DCMAKE_BUILD_TYPE=Debug ../

and on building for KDE4

cmake -DCMAKE_INSTALL_PREFIX=$HOME/umbrello -DCMAKE_BUILD_TYPE=Debug ../

Check the cmake output for missing build requirements and install them

make
make install

Running the program from local installation

Qt5/KF5 builds in a KF5 environment

... to be finished

Qt5/KF5 builds in a KDE4 environment

running umbrello KF5 build in a KDE4 environment requires to use the following commands.

eval `dbus-launch`
kdeinit5
$HOME/umbrello/bin/umbrello &

under a KDE4 environment

Before running umbrello, you need set the KDEDIRS environment variable with:

export KDEDIRS=$HOME/umbrello:$KDEDIRS
kbuildsycoca4

Run the following command from a shell:

$HOME/umbrello/bin/umbrello &

You may add the following commands to your .bashrc or similar login shell config file to have umbrello in the users system path:

export KDEDIRS=$HOME/umbrello:$KDEDIRS
export PATH=$HOME/umbrello/bin:$PATH

With that you can run umbrello simply by typing:

umbrello

Note: There are reports that there may be no tool bar icons after installing umbrello/KDE4 in a non default location. If this happens to you, please install an official umbrello/KDE4 version with your package manager; then start you just created umbrello.

Source Code on Windows

Umbrello could be build on windows from source with the emerge build system.

Cross compile Umbrello for Windows

Umbrello could be cross compiled for Windows from source with the help of the openSUSE Build Service (OBS) provided by the package mingw32-umbrello for 32bit builds and mingw64-umbrello for 64bit builds.

Windows installer and portable packages are provided with mingw32-umbrello-installer and mingw64-umbrello-installer.

The mentioned obs packages provide remote builds by default. Local builds are possible on any Linux system with the help of the OpenSuse command line build client and are useful to inspect and fix hidden issues happening with remote builds like non visible compiler or linker errors.

Global navigation links