mirror of https://github.com/keymanapp/keyman.git synced 2026-09-08 16:47:46 +00:00

History

Marc Durdin b435471b24 feat(developer): add sentry reporting for kmc Fixes #9113. Adds sentry reporting, plus helper functions, for kmc. Includes the now-standard `-sentry-client-test-exception` command line parameter, with `kmcmplib` and `event` sub-options available. Uploads kmc* sourcemaps to sentry on a release build. On Windows, honours the registry setting for error reporting. Also includes a command line option `--[no-]error-reporting` (must be used prior to initial command, e.g. `kmc --no-error-reporting build ...`).		2023-07-11 15:45:41 +07:00
..
src	feat(developer): add sentry reporting for kmc	2023-07-11 15:45:41 +07:00
test	chore(developer): unit test for compilerWarningsAsErrors	2023-07-11 12:14:51 +07:00
.eslintrc.cjs	chore(developer): check for nodejs deps in kmc-kmn	2023-06-08 10:58:06 +07:00
build.sh	fix(common): legacy .kpj schema	2023-07-03 09:06:03 +07:00
Makefile	chore: rename kmc-keyboard to kmc-ldml	2023-05-09 14:08:45 +07:00
package.json	feat(developer): add sentry reporting for kmc	2023-07-11 15:45:41 +07:00
README.md	feat(developer): kmc build command	2023-02-24 13:54:27 +07:00
tsconfig.json	chore: Merge branch 'feature-kmc-kmw' into chore/merge-master-into-feature-kmc-kmw-a17s16-start	2023-06-26 14:33:20 +07:00
tsconfig.kmc-base.json	refactor(developer): split file type management into package	2022-09-27 12:33:10 +10:00

README.md

Keyman Developer - Next Generation Compiler

This package provides the following Keyman command line tools:

kmc — takes LDML Keyboard .xml sources and compiles them in to a KMXPlus .kmx file.
kmlmc — takes lexical model sources and compiles them in to a .js file.
kmlmp — uses a .model.kmp file to generate a redistributable lexical model package.
kmlmi — merges Keyman lexical model .model_info files.

kmlmc is intended to be used standalone, or as part of a build system. kmlmp is used only by command line tools. kmlmi is used exclusively in the lexical-models repository.

Note: kmc will in the future replace kmlmc, kmlmp, and kmlmi.

In order to build lexical models, these tools must be built and compiled.

Install

Install kmc globally:

npm install -g @keymanapp/kmc

kmc Usage

To compile an LDML keyboard from its .xml source, use kmc:

kmc build my-keyboard.xml --outFile my-keyboard.kmx

To see more command line options by using the --help option:

kmc --help

kmlmc Usage

To compile a lexical model from its .model.ts source, use kmlmc:

kmlmc my-lexical-model.model.ts --outFile my-lexical-model.js

To see more command line options by using the --help option:

kmlmc --help
kmlmp --help
kmlmi --help

How to build from source

Run build.sh:

./build.sh configure build

or (less preferably -- build.sh is more efficient):

nmake configure build

Once you have configured once, you should not normally need to do it again unless dependencies change or you clean the build folder. ./build.sh without parameters will do the default action, which is build.

TODO: Note that kmc currently depends on kmc-* to have been configured; while the build of kmc will do the typescript component of the build, it will not be able to do any other build steps, so you may wish to build each of the components separately, one time.

How to run the tests

./build.sh test

How to prepare bundling for installation

./build.sh bundle --build-path <temp_path>

The temp_path must be a path outside the repository to avoid npm getting confused by the root package.json. This is called by inst/download.in.mak normally when building the Keyman Developer installer.

How to publish to NPM

./build.sh publish [--dry-run]

Publishes the current release to NPM. This should only be run from CI.