KDE Utils/Ark: Difference between revisions
m Add link |
Add preliminary build instructions |
||
| Line 1: | Line 1: | ||
= How to build Ark = | = How to build Ark on Linux= | ||
== Step 0 - Install build dependencies == | |||
Some distributions allow to install the build-time dependencies of any package with a single command. For example, on Debian or Ubuntu you can just run the following command: | |||
<syntaxhighlight lang="bash"> | |||
sudo apt-get build-dep ark | |||
</syntaxhighlight> | |||
If you are running the Plasma desktop, you should have most of these dependencies already installed. Usually one needs to manually install only the <code>extra-cmake-modules</code>. | |||
== Step 1 - Build ark == | |||
Like most KDE projects, Ark relies on the CMake build-system. This means that compiling Ark is as simple as running the following commands: | |||
<syntaxhighlight lang="bash"> | |||
mkdir build && cd build | |||
cmake .. | |||
make | |||
</syntaxhighlight> | |||
Everything should work fine, provided that you installed all the required build dependencies. | |||
== Step 2 - Install ark == | |||
Once you built Ark, it's time to install it with the <code>make install</code> command. However, by default CMake will use <tt>/usr/local</tt> as install prefix, so you will have to run <code>sudo make install</code>. | |||
At this point your should be able to run <tt>/usr/local/bin/ark</tt>. If Ark fails to start with the '''Unable to find Ark's KPart component, please check your installation.''' error, you need to run cmake with the additional <tt>-DKDE_INSTALL_USE_QT_SYS_PATHS=ON</tt> argument: | |||
<syntaxhighlight lang="bash"> | |||
cmake -DKDE_INSTALL_USE_QT_SYS_PATHS=ON .. | |||
</syntaxhighlight> | |||
=== Install to custom location === | |||
When running cmake, you can set the install prefix to whatever directory you want to install Ark in. For example | |||
<syntaxhighlight lang="bash"> | |||
cmake -DCMAKE_INSTALL_PREFIX=/home/foo/whatever -DKDE_INSTALL_LIBDIR=lib .. | |||
</syntaxhighlight> | |||
This way you can run <code>make install</code> without having to type to sudo password. However, you will need to set a bunch of environment variables, in order to have everything working: | |||
<syntaxhighlight lang="bash"> | |||
# Install prefix, choose any folder you want | |||
export KF5=~/home/foo/whatever | |||
export XDG_DATA_DIRS=$KF5/share:$XDG_DATA_DIRS | |||
export XDG_CONFIG_DIRS=$KF5/etc/xdg:/etc/xdg | |||
export PATH=$KF5/bin:$PATH | |||
export QT_PLUGIN_PATH=$KF5/lib/plugins:$QT_PLUGIN_PATH | |||
</syntaxhighlight> | |||
== Step 3 - Run tests == | |||
TODO | TODO | ||
Revision as of 13:20, 2 May 2016
How to build Ark on Linux
Step 0 - Install build dependencies
Some distributions allow to install the build-time dependencies of any package with a single command. For example, on Debian or Ubuntu you can just run the following command:
sudo apt-get build-dep ark
If you are running the Plasma desktop, you should have most of these dependencies already installed. Usually one needs to manually install only the extra-cmake-modules.
Step 1 - Build ark
Like most KDE projects, Ark relies on the CMake build-system. This means that compiling Ark is as simple as running the following commands:
mkdir build && cd build
cmake ..
make
Everything should work fine, provided that you installed all the required build dependencies.
Step 2 - Install ark
Once you built Ark, it's time to install it with the make install command. However, by default CMake will use /usr/local as install prefix, so you will have to run sudo make install.
At this point your should be able to run /usr/local/bin/ark. If Ark fails to start with the Unable to find Ark's KPart component, please check your installation. error, you need to run cmake with the additional -DKDE_INSTALL_USE_QT_SYS_PATHS=ON argument:
cmake -DKDE_INSTALL_USE_QT_SYS_PATHS=ON ..
Install to custom location
When running cmake, you can set the install prefix to whatever directory you want to install Ark in. For example
cmake -DCMAKE_INSTALL_PREFIX=/home/foo/whatever -DKDE_INSTALL_LIBDIR=lib ..
This way you can run make install without having to type to sudo password. However, you will need to set a bunch of environment variables, in order to have everything working:
# Install prefix, choose any folder you want
export KF5=~/home/foo/whatever
export XDG_DATA_DIRS=$KF5/share:$XDG_DATA_DIRS
export XDG_CONFIG_DIRS=$KF5/etc/xdg:/etc/xdg
export PATH=$KF5/bin:$PATH
export QT_PLUGIN_PATH=$KF5/lib/plugins:$QT_PLUGIN_PATH
Step 3 - Run tests
TODO Write a tutorial for an ark-friendly kdesrc-build configuration. Reference: https://community.kde.org/Guidelines_and_HOWTOs/Build_from_source
How to contribute to Ark
Development of Ark is tracked on phabricator. This includes code reviews and tasks.
Sending patches
Follow the instructions in the HACKING file: https://phabricator.kde.org/diffusion/ARK/browse/master/HACKING
Coding tasks
You can find a list of currently open tasks in the Ark workboard: https://phabricator.kde.org/tag/ark/