Difference between revisions of "KDE package guidelines"

From ArchWiki
Jump to: navigation, search
(Package naming)
m (Build dir)
Line 5: Line 5:
  
 
== Build dir ==
 
== Build dir ==
A good way of building [[Wikipedia:CMake|CMake]] packages is to make a build dir in the root of the project and run cmake from that dir. So, the build function in the [[PKGBUILD]] should start with the following lines:
+
A good way of building [[Wikipedia:CMake|CMake]] packages is to make a build dir outside the root of the project and run cmake from that dir. So, the build function in the [[PKGBUILD]] should start with the following lines:
 
  mkdir build
 
  mkdir build
 
  cd build
 
  cd build

Revision as of 09:42, 15 July 2012

Template:Package Guidelines

The KDE packages on Arch Linux follow a certain schema.

Build dir

A good way of building CMake packages is to make a build dir outside the root of the project and run cmake from that dir. So, the build function in the PKGBUILD should start with the following lines:

mkdir build
cd build
cmake ../${pkgname}-${pkgver}

Install prefix

Follow the Arch Packaging Standards, every packages must set the CMAKE_INSTALL_PREFIX variable, so please use:

-DCMAKE_INSTALL_PREFIX=/usr

Build type

Please specify the build type, this makes really simple rebuild a package with debug symbols by just using a sed rule.

-DCMAKE_BUILD_TYPE=Release

Package naming

Plasmoids

Plasmoids packages should be named kdeplasma-applets-plasmoidname so that they are recognizable as KDE related packages; this also distinguishes them from the officials one.

Runners

Runners packages should be named kdeplasma-runners-runnername so that they are recognizable as KDE related packages; this also distinguishes them from the officials one.

.install files

For many KDE packages, all .install files look almost exactly the same. Some packages install icons in the hicolor icon theme; use the xdg-icon-resource util provided by the xdg-utils package which is a dependence of the qt package. So use this line:

xdg-icon-resource forceupdate --theme hicolor &> /dev/null

Many packages install Freedesktop.org compatible .desktop files and register MimeType entries in them. Running update-desktop-database in post_install is recommended as that tool is provided by the desktop-file-utils package which is a dependence of the qt package. So use this line:

update-desktop-database -q