kde-extraapps/amarok/HACKING/building_amarok2_in_home.txt
2015-01-31 00:30:50 +00:00

92 lines
3.1 KiB
Text

This document explains how to install Amarok 2 from git in your home directory - in an easy way :)
==================================================================================================
A detailed blog post on how to make a local build can be found here: http://blogs.fsfe.org/myriam/2009/09/26/compiling-amarok-from-git-locally-full-summary/
* If you already have Amarok installed from your distro, uninstall it to prevent setting conflicts and similar.
* Install git, the compiler and KDE 4 development packages:
In Kubuntu, Debian, and all their derivatives:
sudo aptitude install git-core build-essential kdesdk kdelibs5-dev libkonq5-dev kdebase-workspace-dev
In Archlinux:
sudo pacman -Sy git base-devel kdelibs kdebase-runtime
In Gentoo:
sudo emerge -av dev-util/git kdelibs plasma-workspace
In OpenSuSE:
sudo zypper install git
In Fedora:
sudo yum install git kdelibs-devel
* Install ccache to speed up compilation
ccache -M 2G
* Append the following to $HOME/.bashrc:
export PATH=$HOME/kde/bin:$PATH
export KDEDIR=$HOME/kde
export KDEDIRS=$KDEDIR
* Reload your edited .bashrc:
source $HOME/.bashrc
NOTE: if you are not using the bash shell, edit your proper shell config file (~/.zshrc or ~/.tcshrc or whatever it may be)
* Make KDE aware of Amarok's plugin location:
echo 'export KDEDIR=$HOME/kde' >> $HOME/.kde/env/myenv.sh
echo 'export KDEDIRS=$KDEDIR' >> $HOME/.kde/env/myenv.sh
Some distributions call the above folder $HOME/.kde4/... (OpenSuSE in particular).
* Create folders:
mkdir $HOME/kde
mkdir $HOME/kde/src
mkdir -p $HOME/kde/build/amarok
* Make sure you have all necessary dependencies
See the README file for the complete list of necessary dependencies. Make sure you have the development files of these packages.
For distribution specific requirements refer to http://community.kde.org/Amarok/Development/Development_HowTo
* Check out Amarok:
cd $HOME/kde/src
git clone git://anongit.kde.org/amarok
* Building:
cd $HOME/kde/build/amarok
cmake -DCMAKE_INSTALL_PREFIX=$HOME/kde -DCMAKE_BUILD_TYPE=debugfull $HOME/kde/src/amarok
make install
* Enabling unit tests:
If you are a regular Amarok contributor, please build with tests enabled.
Install gmock from http://code.google.com/p/googlemock/
Add the following flag to your cmake line: -DKDE4_BUILD_TESTS=ON
Once compiled, jsut run the tests with 'make test'
For more information about the test infrastructure, read the Qtestlib Manual: http://doc.trolltech.com/4.5/qtestlib-manual.html
* Updating KDE Config:
kbuildsycoca4 --noincremental
Now you are ready to run Amarok 2, by typing "amarok" in the shell :)
Please also refer to the following wiki page
http://techbase.kde.org/Getting_Started/Sources/KDE_git-tutorial
NOTE:
If you have installed MySQL Embedded in non-default location (i.e. $HOME/usr),
Amarok may fail to start with error regarding libmysqlclient library. In this
case, add the following string to your ~/.bashrc:
export LD_LIBRARY_PATH=$HOME/usr/lib/mysql:$LD_LIBRARY_PATH
where $HOME/usr is the path you've used in --prefix option.
Have fun :)