The Vector SIL Kit Packaging REPO

Prerequisites

Terminology

If during the course of this README you stumble upon $VERSION, this is a short placeholder for the typical SEMVER $MAJOR.$MINOR.$REVISION placeholder. Placeholderception if you will!

Packages

To build the libsilkit4 package, you will need the debhelper and debhelper-cmake tools:

• debhelper
• devscripts
• dh-cmake

To build sil-kit itself, you will need the following packages:

• cmake
• ninja-build
• libfmt-dev
• libspdlog-dev
• libasio-dev
• libyamlcpp-dev
• libgtest-dev
• libgmock-dev

Install these packages via:

> sudo apt install debhelper dpkg-dev dh-cmake devscripts dh-cmake cmake ninja-build \
  libfmt-dev libspdlog-dev libasio-dev libyamlcpp-dev libgtest-dev libgmock-dev

Setting up the build environment

sil-kit-pkg is setup to work with Github Actions out of the box. But since the main workhorse of the Workflow is the build_deb.sh shellscript, which you can find in .github/actions/build_deb.sh, you can also build it locally yourself! The build_deb.sh uses environment variables for its setup. These environment variable map to parameters that you can set in the github action.

The following environment variables need to be set

SILKIT_SOURCE_URL: Points to the SIL Kit sources:

export SILKIT_SOURCE_URL=https://github.com/vectorgrp/sil-kit

SILKIT_PKG_URL: URL to the sil-kit-pkg sources:

export SILKIT_PKG_URL=/path/to/sil-kit-pkg  # To use a local sil-kit-pkg
export SILKIT_PKG_URL=https://git.repo.com/your-sil-kit-pkg.git # Use a specific sil-kit-pkg git repo

DEBFULLNAME: Name of the package maintainer/creator:

export DEBFULLNAME="Awesome Dev"

DEBEMAIL: Email of the package maintainer/creator:

export DEBEMAIL=awesome_dev@your-domain.something

These environment variables also map to Github Actions input parameters. Additional Parameters for the CI ================================

In addition to the environment variables (used by build_deb.sh), the Github Action uses some more inputs to identify/store the correct artifacts

• debian_arch

  The cpu architecture the debian package is build for. Currently we only support/test on amd64

Building the package

Locally

Some further prerequisites:

• Debian SID (as of January 2024) or Ubuntu 23.04 and higer!

  Earlier versions of Ubuntu might not work, as the dependencies needed are too old to work with SIL Kit!

• We build the package directly in the sil-kit-pkg directory.

  You can copy the script to anywhere on your system, just adapt SILKIT_PKG_URL accordingly

• sil-kit-pkg is versioned akine to sil-kit, e.g. sil-kit-pkg version 4.0.44 will ONLY build sil-kit 4.0.44

  This is due to strict (and correct) version handling for Debian packages They will always be versioned and the intent is to only built correct versioned packages and it should not be possible to build version 4.0.32 and pretend it is 4.0.44 in the Debian package. So if you want to build sil-kit version X.Y.Z you need to checkout the vX.Y.Z tag of sil-kit-pkg.

Setting up the environment

Building the package

When you have acquired the correct dependencies and done the correct setup all you need to do is

2-5 minutes later a freshly build

• libsilkit4_4.0.45-1_amd64.deb
• libsilkit-dev_4.0.45-1_amd64.deb
• silkit-utils_4.0.45-1_amd64.deb

will be available in your working directory.

Github CI

If you have forked sil-kit-pkg and you can use Github Actions, this is how you can build a libsilkit4 package

How to get to the Action

• Click on the Actions tab in your Github repo
• Click on the .github/workflows/package-debian.yml tab
• Click on the Run Workflow tab

Setup for the Workflow

See Setting up the environment. Additionally set the following variables:

• DEBIAN_ARCH

  amd64

Click the Run Workflow Button. The .deb packages will be in the artifacts of this Workflow run