View source for Neon/Locally build packages

This page describes some basics in taking a package from https://invent.kde.org/neon/ and building it locally. This can be useful for doing local testing before committing changes.

= Prerequisites =

* A pre-existing KDE [https://community.kde.org/Get_Involved/development development environment].
* <code>dpkg-dev</code> and <code>xbuilder</code> packages will include the standard Debian toolchain for building packages.

= Setting up local files for building package =
# Clone the package repository repository, i.e. https://invent.kde.org/neon/kde/libkdegames
# Copy the source tree from your kde sources to where the <code>debian/</code> path resides.
# Create a <code>usr/share/locale</code> to simulate CI locale injection, <code>mkdir -p usr/share/locale && touch usr/share/locale/stub</code>
# Remove symbols to simulate CI removing the symbol files, <code>rm debian/*.symbols</code>
# Change debian/source/format to use native instead of quilt, <code>sed -i 's/quilt/native/' debian/source/format</code>
# Apply patches, <code>QUILT_PATCHES=debian/patches quilt push -a</code>

Or, in one command:

<code>mkdir -p usr/share/locale && touch usr/share/locale/stub && rm -f debian/*.symbols && sed -i 's/quilt/native/' debian/source/format && QUILT_PATCHES=debian/patches quilt push -a</code>

= Building the package =

Use your favorite tool:
* <code>dpkg-buildpackage</code>
* <code>debuild</code>

= Known false negatives =

* Complaints about dsc and missing key.
* Lintian returns <code>malformed-debian-changelog-version</code>.

= Speeding up compilation =

A compiler cache can help speed things up immensely, particularly when it comes to packages that take a while to compile.

Install <code>ccache</code>. It might be worth also setting these options:
* <code>ccache -o max_size="20G"</code> - Increases the cache size to 20G, roughly kdesrc-build uses about 12G currently and the default is 10G.
* <code>ccache -o compression="true"</code> - Enable compression, reduces cache size by compressing objects.
* <code>ccache -o compression_level="9"</code> - Highest level of compression, helps utilize your space significantly better at a relatively minimal performance cost.

Configure <code>~/.devscripts</code> to use <code>ccache</code> when using <code>debuild</code>:

<code>echo 'DEBUILD_PREPEND_PATH="/usr/lib/ccache"' | tee -a ~/.devscripts</code>

Now you should be able to use <code>debuild</code> with ccache. You may want to validate this by checking its' usage statistics while building, use <code>ccache -s</code>.