How to test artifacts from pull requests for Keyman for Linux

Each pull request (PR) that touches files from Keyman for Linux or core processor gets build on our Jenkins continuous integration server. Testing those packages requires some manual steps.

Prerequisites

• create an account on Jenkins (see below)
• install the current Keyman alpha packages. This is necessary so that you have all the dependencies installed.

Downloading and installing PR packages

Downloading

The "Pull Requests" tab of the pipeline-keyman-packaging job lists the recent pull requests. Clicking on a PR shows the builds for that PR. At the top of the page is a "Last Successful Artifacts" link. You can either download all artifacts in a zip file, or click on the "results" link and then download only the packages for your Ubuntu version.

If you downloaded all artifacts, unpack the zip file.

Installing

You can install the packages in a terminal window with:

cd Downloads # replace with the location of the .deb files
sudo dpkg -i \
{ibus-keyman,ibus-kmfl,keyman,keyman-config,keyman-keyboardprocessor,kmflcomp,libkmfl,libkmnkbp0,python3-keyman-config}*$(lsb_release -s -c)*.deb

Creating an account on Jenkins

In order to be able to download artifacts you need an account on the Jenkins continuous integration server. Please use firstname_lastname in all lowercase characters as account name. After account creation send an email to gerrit at sil.org with your username so that you can be given the necessary permissions.