keymanapp · keyman-server · Jun 23, 2026 · Jun 24, 2026 · Jun 25, 2026 · Jun 25, 2026
diff --git a/.github/workflows/deb-packaging.yml b/.github/workflows/deb-packaging.yml
@@ -137,7 +137,7 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        dist: [jammy, noble, questing]
+        dist: [jammy, noble, resolute]
 
     steps:
     - name: Checkout

diff --git a/.gitignore b/.gitignore
@@ -186,3 +186,7 @@ lcov.info
 
 # flag file for build script
 .configured
+
+# see common/tools/api-extractor/README.md
+tsdoc.json
+api-extractor.json
diff --git a/HISTORY.md b/HISTORY.md
@@ -1,5 +1,49 @@
 # Keyman Version History
 
+## 19.0.258 alpha 2026-07-15
+
+* chore(android): remove doc for non-existing deprecated functions (#16244)
+
+## 19.0.257 alpha 2026-07-14
+
+* chore(linux): remove questing, add stonking (#16236)
+* chore(android): cleanup Android build scripts and artifact filenames (#16234)
+* chore(web): declare scope for stubAndKeyboardCache members (#16221)
+* fix(android): improve clarity of keyboard script error popup (#16228)
+* chore(android): log legacy cloud keyboards (#16237)
+* chore(android): cleanup font variable names, remove obsolete code (#16211)
+
+## 19.0.256 alpha 2026-07-13
+
+* fix(android): add permissions for Sentry and set default keyboard (#16216)
+* maint(resources): add extra debug reporting for builder (#16230)
+
+## 19.0.255 alpha 2026-07-11
+
+* maint(android): use KEYMAN_TIER instead of TIER.md (#16219)
+* feat(ios): add keyman-version to package-version check (#16138)
+* docs(web): cleanup of index pages and page titles (#16171)
+* feat(android): add keyman-version to package-version check (#16139)
+
+## 19.0.254 alpha 2026-07-10
+
+* fix(android): handle blank keyboard tap properly (#16217)
+* fix(web): define IME interfaces in `KeyboardInterfaceBase` (#16170)
+
+## 19.0.253 alpha 2026-07-09
+
+* fix(web): resync model in `set osk()` (as used by Server) (#16127)
+* chore(developer): consolidate api-extractor usage in Developer (#16135)
+
+## 19.0.252 alpha 2026-07-08
+
+* chore(linux): reorder buttons on kmp install window (#16210)
+* refactor(web): rename `keymanweb` to `keyman` in UI modules (#16174)
+* chore: remove deprecated "X-UA-Compatible" and "apple-mobile-web-app-capable" metas (#16176)
+* fix(android): refactor `KMLog` - simplification and added resilience (#16152)
+* fix(android): differentiate between fontPath and fontUrl in Keyman Engine for Android (#16188)
+* fix(web): fixes cookie unit-tests and path for OSK resources during testing (#16209)
+
 ## 19.0.251 alpha 2026-07-02
 
 * fix(android): skip test on Windows that triggers androidx WebKit bug (#16184)

diff --git a/VERSION.md b/VERSION.md
@@ -1 +1 @@
-19.0.252
+19.0.259
diff --git a/android/KMAPro/build.sh b/android/KMAPro/build.sh
@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
-# Build Keyman for Android app (KMAPro)
+# Keyman is copyright (C) SIL Global. MIT License.
+#
 ## START STANDARD BUILD SCRIPT INCLUDE
 # adjust relative paths as necessary
 THIS_SCRIPT="$(readlink -f "${BASH_SOURCE[0]}")"
@@ -9,111 +10,92 @@ THIS_SCRIPT="$(readlink -f "${BASH_SOURCE[0]}")"
 . "$KEYMAN_ROOT/resources/build/utils.inc.sh"
 . "$KEYMAN_ROOT/resources/build/build-help.inc.sh"
 . "$KEYMAN_ROOT/resources/build/build-download-resources.sh"
-
 . "$KEYMAN_ROOT/android/KMAPro/build-play-store-notes.inc.sh"
 
 # ################################ Main script ################################
 
-# Definition of global compile constants
-
-CONFIG="release"
-BUILD_FLAGS="build -x lint -x test"                     # Gradle build w/o test
-TEST_FLAGS="-x assembleRelease lintRelease testRelease" # Gradle test w/o build
-DAEMON_FLAG=
-
 builder_describe "Builds Keyman for Android app." \
   "@/android/KMEA" \
   "clean" \
   "configure" \
   "build" \
-  "test             Runs lint and unit tests." \
-  "publish-symbols  Publishes symbols to Sentry." \
+  "test                Runs lint and unit tests." \
+  "publish-symbols     Publishes symbols to Sentry." \
   "publish-play-store  Publishes the APK to the Play Store."
 
-# parse before describe_outputs to check debug flags
 builder_parse "$@"
 
 if builder_is_debug_build; then
-  builder_heading "### Debug config ####"
-  CONFIG="debug"
   BUILD_FLAGS="assembleDebug -x lintDebug -x testDebug"
   TEST_FLAGS="-x assembleDebug lintDebug testDebug"
+else
+  BUILD_FLAGS="build -x lint -x test"                     # Gradle build w/o test
+  TEST_FLAGS="-x assembleRelease lintRelease testRelease" # Gradle test w/o build
 fi
 
+if builder_is_ci_build; then
+  GRADLE_DAEMON=--no-daemon
+else
+  GRADLE_DAEMON=
+fi
+
+# Locations for bundled keyboard and lexical model
+
 KEYBOARD_PACKAGE_ID="sil_euro_latin"
 KEYBOARDS_TARGET="android/KMAPro/kMAPro/src/main/assets/${KEYBOARD_PACKAGE_ID}.kmp"
 MODEL_PACKAGE_ID="nrc.en.mtnt"
 MODELS_TARGET="android/KMAPro/kMAPro/src/main/assets/${MODEL_PACKAGE_ID}.model.kmp"
+
 builder_describe_outputs \
   configure     "/${MODELS_TARGET}" \
-  build         /android/KMAPro/kMAPro/build/outputs/apk/$CONFIG/keyman-${KEYMAN_VERSION_FOR_FILENAME}.apk
-
-#### Build
-
-
-# Parse args
-
-if builder_is_ci_build; then
-  DAEMON_FLAG=--no-daemon
-fi
+  build         /android/KMAPro/kMAPro/build/outputs/apk/$BUILDER_CONFIGURATION/keyman-${KEYMAN_VERSION_FOR_FILENAME}.apk
 
 #### Build action definitions ####
 
-# Check about cleaning artifact paths
-if builder_start_action clean; then
-  rm -rf "$KEYMAN_ROOT/android/KMAPro/kMAPro/build/outputs"
-  builder_finish_action success clean
-fi
-
-if builder_start_action configure; then
-
+do_configure() {
   downloadKeyboardPackage "$KEYBOARD_PACKAGE_ID" "${KEYMAN_ROOT}/$KEYBOARDS_TARGET"
   downloadModelPackage "$MODEL_PACKAGE_ID" "${KEYMAN_ROOT}/$MODELS_TARGET"
+}
 
-  builder_finish_action success configure
-fi
-
-if builder_start_action build; then
-
+do_build() {
   # Copy Keyman Engine for Android
-  cp "${KEYMAN_ROOT}/android/KMEA/app/build/outputs/aar/keyman-engine-${CONFIG}.aar" "${KEYMAN_ROOT}/android/KMAPro/kMAPro/libs/keyman-engine.aar"
+  cp "${KEYMAN_ROOT}/android/KMEA/app/build/outputs/aar/keyman-engine-${BUILDER_CONFIGURATION}.aar" "${KEYMAN_ROOT}/android/KMAPro/kMAPro/libs/keyman-engine.aar"
 
   # Convert markdown to html for offline help
   build_help_html android KMAPro/kMAPro/src/main/assets/info
 
-  echo "BUILD_FLAGS $BUILD_FLAGS"
-  ./gradlew $DAEMON_FLAG clean $BUILD_FLAGS
+  builder_echo "BUILD_FLAGS $BUILD_FLAGS"
+  ./gradlew $GRADLE_DAEMON $BUILD_FLAGS
 
-  mv "${KEYMAN_ROOT}/android/KMAPro/kMAPro/build/outputs/apk/$CONFIG/keyman-${KEYMAN_VERSION}.apk" "${KEYMAN_ROOT}/android/KMAPro/kMAPro/build/outputs/apk/$CONFIG/keyman-${KEYMAN_VERSION_FOR_FILENAME}.apk"
-
-  builder_finish_action success build
-fi
-
-if builder_start_action test; then
-
-  echo "TEST_FLAGS $TEST_FLAGS"
-  ./gradlew $DAEMON_FLAG $TEST_FLAGS
+  mv "${KEYMAN_ROOT}/android/KMAPro/kMAPro/build/outputs/apk/$BUILDER_CONFIGURATION/keyman-${KEYMAN_VERSION}.apk" "${KEYMAN_ROOT}/android/KMAPro/kMAPro/build/outputs/apk/$BUILDER_CONFIGURATION/keyman-${KEYMAN_VERSION_FOR_FILENAME}.apk"
+}
 
-  builder_finish_action success test
-fi
+do_test() {
+  builder_echo "TEST_FLAGS $TEST_FLAGS"
+  ./gradlew $GRADLE_DAEMON $TEST_FLAGS
+}
 
-publish_symbols() {
+do_publish_symbols() {
   if builder_is_ci_build && builder_is_ci_build_level_release; then
     # TODO: what does publishSentry even do?
-    ./gradlew $DAEMON_FLAG publishSentry
+    ./gradlew $GRADLE_DAEMON publishSentry
     builder_echo "Making a Sentry release for tag $KEYMAN_VERSION_GIT_TAG"
     sentry-cli upload-dif -p keyman-android --include-sources
     sentry-cli releases -p keyman-android files $KEYMAN_VERSION_GIT_TAG upload-sourcemaps ./
   fi
 }
 
-publish_play_store() {
+do_publish_play_store() {
   if builder_is_ci_build && builder_is_ci_build_level_release; then
     generateReleaseNotes
     # Publish Keyman for Android to Play Store
-    ./gradlew $DAEMON_FLAG publishReleaseApk
+    ./gradlew $GRADLE_DAEMON publishReleaseApk
   fi
 }
 
-builder_run_action publish-symbols      publish_symbols
-builder_run_action publish-play-store  publish_play_store
+builder_run_action clean               rm -rf "$KEYMAN_ROOT/android/KMAPro/kMAPro/build"
+builder_run_action configure           do_configure
+builder_run_action build               do_build
+builder_run_action test                do_test
+builder_run_action publish-symbols     do_publish_symbols
+builder_run_action publish-play-store  do_publish_play_store
diff --git a/android/KMAPro/kMAPro/build.gradle b/android/KMAPro/kMAPro/build.gradle
@@ -8,8 +8,7 @@ plugins {
 
 ext.rootPath = '../../'
 apply from: "$rootPath/version.gradle"
-
-String tier = new File('../../TIER.md').getText('UTF-8').trim();
+String tier = System.getenv("KEYMAN_TIER");
 
 java {
     toolchain {

diff --git a/android/KMAPro/kMAPro/src/main/java/com/tavultesoft/kmapro/WebBrowserActivity.java b/android/KMAPro/kMAPro/src/main/java/com/tavultesoft/kmapro/WebBrowserActivity.java
@@ -1,9 +1,10 @@
-/**
- * Copyright (C) 2017 SIL International. All rights reserved.
+/*
+ * Keyman is copyright (C) SIL Global. MIT License.
  */
 
 package com.tavultesoft.kmapro;
 
+import java.io.File;
 import java.io.UnsupportedEncodingException;
 import java.net.MalformedURLException;
 import java.net.URL;
@@ -386,7 +387,7 @@ protected void onResume() {
     super.onResume();
     if (webView != null) {
       if (didFinishLoading) {
-        String fontFilename = KMManager.getKeyboardTextFontFilename();
+        String fontFilename = getKeyboardTextFontFilenameOnly();
         if (!loadedFont.equals(fontFilename)) {
           webView.reload();
         }
@@ -432,8 +433,19 @@ public void onBackPressed() {
     }
   }
 
+  /**
+   * Returns the filename without path of the display font of the current keyboard.
+   */
+  private String getKeyboardTextFontFilenameOnly() {
+    String fontPath = KMManager.getKeyboardTextFontFilename();
+    if (fontPath == null || fontPath.isEmpty()) {
+      return "";
+    }
+    return new File(fontPath).getName();
+  }
+
   private void loadFont() {
-    String font = KMManager.getKeyboardTextFontFilename();
+    String font = getKeyboardTextFontFilenameOnly();
     if (!font.isEmpty()) {
       loadedFont = font;
       String fontUrl = String.format("%s%s", fontBaseUri, font);

diff --git a/android/KMEA/app/build.gradle b/android/KMEA/app/build.gradle
@@ -8,7 +8,7 @@ ext.rootPath = '../../'
 apply from: "$rootPath/version.gradle"
 
 base {
-    // Specify library filename keyman-engine-$CONFIG.aar
+    // Specify library filename keyman-engine-$BUILDER_CONFIGURATION.aar
     archivesName = "keyman-engine"
 }
 

diff --git a/android/KMEA/app/src/main/assets/android-host.js b/android/KMEA/app/src/main/assets/android-host.js
@@ -22,10 +22,6 @@ sentryManager.init();
 
 window.addEventListener('load', init, false);
 
-function loadDefaultKeyboard() {
-  notifyHost('reloadAfterError');
-}
-
 function init() {
   //document.body.style.backgroundColor="transparent";
   //window.console.log('Device type = '+device);
@@ -82,7 +78,19 @@ function init() {
   keyman.addEventListener('keyboardchange', setIsChiral);
   keyman.core.languageProcessor.on('statechange', onStateChange);
 
-  document.body.addEventListener('touchend', loadDefaultKeyboard);
+  // If the keyboard fails to display, this usually indicates that a Javascript
+  // error has occurred, perhaps in the active keyboard. So we have a last-gasp
+  // fallback in that situation; if the user touches the blank document, we will
+  // attempt to reload the default keyboard.
+  document.addEventListener('touchend', (event) => {
+    if(event.target == document.documentElement) {
+      // The error will be reported through to Sentry if the user has error
+      // reporting enabled; breadcrumbs can give us helpful details on possible
+      // root causes for the error
+      window.console.error('user touched the document body, which can only happen if the keyboard was not presented. This is usually caused by another error.');
+      notifyHost('reloadAfterError');
+    }
+  });
 
   notifyHost('pageLoaded');
 }