Keyman 15.0 New Functionality

How to use this document

This document is a work-in-progress capturing changes in version 15.0 of Keyman. It will be transferred to help.keyman.com on the release of version 15.0.

Don't worry too much about getting the wording totally consistent. The aim here is to capture the knowledge of changes while they are fresh. We will review and tidy up the document before release.

If a change may introduce issues for other developers, mark it with BREAKING.

This does not necessarily need to correspond to Pull Request IDs as in many cases there may be many PRs for one issue. If you can do this, then good, but don't stress over it.

You can make good use of HISTORY.md for populating this initially.

Significant and Breaking Changes for Developers

Anything that other developers should be aware of should be documented here. This set of people includes:

• Keyboard developers
• Developers of websites that use KeymanWeb
• Developers of apps that embed or interface with Keyman Engine (KAB, FieldWorks, etc)
• Tool developers, e.g. .kmn language changes may impact other tools

Include major new functionality that they may need to cater to, and anything that changes the way someone may use Keyman from a development perspective.

We'll also document major new features for all users here.

All Platforms

Android

• Added options to control text on spacebar. (#5349)
• Globe key now supports long press and short press for simpler switching. (#5437)
• Keyman for Android now enforces minimum Chrome version 37.0. (#????)

iOS

• Added options to control text on spacebar (#5365)

Linux

macOS

Web

• BREAKING KeymanWeb's OSK field (keyman.osk) is now only available after the promise returned from keyman.init is fulfilled. (#????)
• KeymanWeb will now look for a registerEvents function on UI modules; this function will be called once the OSK is built. (#????)
• The CSS styling patterns for the OSK's layout properties and font-size specification have been made more consistent; desktop and touch now set the same style properties on the same elements within the keyboard. (#????)

Windows

Keyman Developer (keyboard development)

• Updated kmconvert to support platform targets and included it in the standalone kmcomp.zip deployment for Linux and macOS keyboard developers. (#5082)
• Lexical models compiled with Developer 12 or 13 should be rebuilt with Developer 14 or 15 in order to preserve a user's casing for the currently-typed word if it is also available as a suggestion. (#5429)
• use() and match behavior for web now matches desktop platforms. This requires a keyboard rebuild with the 15.0 compiler, but will affect any rebuilt keyboard, regardless of its target compiler version. (#5525)

Keyman Engine and Keyman Core

• Engine(Web: Added APIs to control text on spacebar. (#5348)
• Engine(Android): Added APIs to control text on spacebar. (#5349)
• Engine(iOS): Added APIs to control text on spacebar. (#5365)
• Core: Added debugger interface. (#5425)
• Core: BREAKING Removed capsLock from KMX_Environment; use modifier flag instead. (#5432)
• Core: BREAKING km_kbp_process_event now has an additional parameter, is_key_down. (#5432)
• Core: KM_KBP_IT_CAPSLOCK action type: Added new union member capsLock to km_kbp_action_item. When the core needs to enable or disable Caps Lock, it creates a KM_KBP_IT_CAPSLOCK action with km_kbp_action_item.capsLock set to 1 to enable Caps Lock or 0 to disable. (#????)