keymanapp · keyman-server · May 29, 2026 · Jun 22, 2026 · Jun 22, 2026 · Jun 23, 2026
diff --git a/.github/workflows/api-verification.yml b/.github/workflows/api-verification.yml
@@ -71,7 +71,7 @@ jobs:
     - name: "Verify API for libkeymancore*.so (${{ steps.environment_step.outputs.GIT_BRANCH }}, branch ${{ steps.environment_step.outputs.GIT_BASE_BRANCH }}, by ${{ steps.environment_step.outputs.GIT_USER }})"
       if: steps.environment_step.outputs.SKIP_API_CHECK != 'true'
       run: |
-        echo "Verify API for libkeymancore*.so (${{ steps.environment_step.outputs.GIT_BRANCH }}, branch ${{ steps.environment_step.outputs.GIT_BASE_BRANCH }}, by ${{ steps.environment_step.outputs.GIT_USER }}):" >> $GITHUB_STEP_SUMMARY
+        echo "Verify API for libkeymancore*.so (${{ steps.environment_step.outputs.GIT_BRANCH }}, branch ${{ steps.environment_step.outputs.GIT_BASE_BRANCH }}, by ${{ steps.environment_step.outputs.GIT_USER }}):" | tee -a ${GITHUB_STEP_SUMMARY}
 
         BIN_PACKAGE=$(ls "${GITHUB_WORKSPACE}/artifacts/" | grep "${PKG_NAME}[0-9]*_${{ steps.environment_step.outputs.KEYMAN_VERSION }}-1${{ steps.environment_step.outputs.PRERELEASE_TAG }}+$(lsb_release -c -s)1_amd64.deb")
         cd ${{ github.workspace }}/keyman/linux
@@ -80,7 +80,7 @@ jobs:
           --bin-pkg "${GITHUB_WORKSPACE}/artifacts/${BIN_PACKAGE}" \
           --git-sha "${{ steps.environment_step.outputs.GIT_SHA }}" \
           --git-base "${{ steps.environment_step.outputs.GIT_BASE }}" \
-          verify 2>> $GITHUB_STEP_SUMMARY
+          verify 2> >(tee -a ${GITHUB_STEP_SUMMARY} >&2)
 
     - name: Archive .symbols file
       if: steps.environment_step.outputs.SKIP_API_CHECK != 'true' && always()

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,77 @@
 # 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)
+
+## 19.0.250 alpha 2026-07-01
+
+* fix(android): use `WebViewAssetLoader` for loading assets on Android (address regression in 19.0.242) (#16146)
+* fix(ios): bundle in KMW's globe-hint.css (#16142)
+* fix(ios): load host page, keyboards through a consistent WKURLSchemeHandler (#16136)
+
+## 19.0.249 alpha 2026-06-30
+
+* fix(windows): add update property to remote check (#16126)
+* chore(android): allow to build FV app in docker container (#16163)
+* fix(developer): warn only on race when destroying TAppSourceHttpResponder (#16140)
+* fix(developer): map shift key nextlayer property when importing OSK (#16110)
+
+## 19.0.248 alpha 2026-06-29
+
+* chore: add missing line to history (#16154)
+* maint(resources): DRY out `PRInformation` interface (#16158)
+* fix(developer): prevent clone of legacy keyboards with no source (#16111)
+* fix(developer): consolidate user options in TypeScript code (#16134)
+* fix(developer): fixup references to layer after deleting in Touch Layout Editor (#16129)
+* fix(web): revert regression in setting `activeKeyboard` in `set osk` (#16156)
+* test(web): add e2e tests for examples from guide (#16108)
+* maint(linux): show output of API check also in log file (#16153)
+
 ## 19.0.247 alpha 2026-06-16
 
 * chore: update multi-labeler to 5.0.0 (#16100)
@@ -39,6 +111,7 @@
 
 ## 19.0.241 alpha 2026-06-02
 
+* chore: web-core preflight (#16015)
 * chore(web): web-core preflight - strip core references (#16040)
 * docs: add note on how to use composer on dockerized websites (#16029)
 * fix(web): fix race displaying active keyboard in menu (#16042)

diff --git a/VERSION.md b/VERSION.md
@@ -1 +1 @@
-19.0.248
+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 {
@@ -173,10 +172,11 @@ dependencies {
     implementation 'androidx.constraintlayout:constraintlayout:2.2.1'
     implementation 'com.google.android.material:material:1.12.0'
     implementation 'com.stepstone.stepper:material-stepper:4.3.1'
+    implementation 'androidx.webkit:webkit:1.14.0'
     implementation files('libs/keyman-engine.aar')
     implementation 'io.sentry:sentry-android:8.19.1'
     implementation 'androidx.preference:preference:1.2.1'
-    implementation "com.android.installreferrer:installreferrer:2.2"
+    implementation 'com.android.installreferrer:installreferrer:2.2'
 
     // Add dependency for generating QR Codes
     // (Even though it's embedded in KMEA, because we're manually copying keyman-engine.aar,

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"
 }
 
@@ -72,6 +72,7 @@ dependencies {
     implementation 'commons-io:commons-io:2.16.1'
     implementation 'io.sentry:sentry-android:8.19.1'
     implementation 'androidx.preference:preference:1.2.1'
+    implementation 'androidx.webkit:webkit:1.14.0'
 
     // Robolectric
     testImplementation 'androidx.test.ext:junit:1.2.1'

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');
 }