npm packages

This is a guide for how the various Keyman npm packages are developed and published.

npm packages are published on the CI (continuous integration) server. Currently, we're using TeamCity for this.

Packages are never published from a developer's machine.

List of current published npm packages

@keymanapp/models-types -- located at common/models/types
@keymanapp/kmc -- located at developer/src/kmc
@keymanapp/kmc-keyboard -- located at developer/src/kmc-keyboard
@keymanapp/kmc-model -- located at developer/src/kmc-model
@keymanapp/kmc-model-info -- located at developer/src/kmc-model-info
@keymanapp/kmc-package -- located at developer/src/kmc-package

Deprecated npm packages

@keymanapp/lexical-model-compiler -- replaced by @keymanapp/kmc

For CI developers

In general

Before publishing, a package must be built and tested on the CI server.

This is typically done with:

./build.sh configure build test

Once the build succeeds and the tests pass, you can publish! Use the following script for this (only on the CI server!); during this, the version is set in package.json:

./build.sh publish

It is then uploaded to the npm package directory. Ensure that the compiled sources are included in the tarball. For example:

$ ./build.sh publish
npm notice
npm notice 📦  @keymanapp/kmc@16.0.61-alpha-local
npm notice === Tarball Contents ===
npm notice 841B   Makefile
npm notice 2.8kB  README.md
npm notice 2.5kB  build.sh
npm notice 116B   build/src/kmc.d.ts
npm notice 114B   build/src/kmc.d.ts.map
npm notice 2.8kB  build/src/kmc.js
npm notice 2.6kB  build/src/kmc.js.map
npm notice 120B   build/src/kmlmc.d.ts
npm notice 118B   build/src/kmlmc.d.ts.map
npm notice 1.4kB  build/src/kmlmc.js
npm notice 1.4kB  build/src/kmlmc.js.map
npm notice 131B   build/src/kmlmi.d.ts
npm notice 118B   build/src/kmlmi.d.ts.map
npm notice 3.1kB  build/src/kmlmi.js
npm notice 2.7kB  build/src/kmlmi.js.map
npm notice 128B   build/src/kmlmp.d.ts
npm notice 118B   build/src/kmlmp.d.ts.map
npm notice 1.6kB  build/src/kmlmp.js
npm notice 1.5kB  build/src/kmlmp.js.map
npm notice 285B   build/src/util/sysexits.d.ts
npm notice 186B   build/src/util/sysexits.d.ts.map
npm notice 51B    build/src/util/sysexits.js
npm notice 128B   build/src/util/sysexits.js.map
npm notice 29.8kB build/tsconfig.tsbuildinfo
npm notice 5.4kB  bundle.inc.sh
npm notice 1.7kB  package.json
npm notice 2.8kB  src/kmc.ts
npm notice 1.4kB  src/kmlmc.ts
npm notice 3.2kB  src/kmlmi.ts
npm notice 1.6kB  src/kmlmp.ts
npm notice 237B   src/util/sysexits.ts
npm notice 740B   tsconfig.json
npm notice 449B   tsconfig.kmc-base.json

For every release of Keyman Developer, the CI publishes a release of @keymanapp/kmc. The version number is locked with the particular version of Keyman Developer.

`set_npm_version`

This helper function sets the version in the package.json for the given package, according to the VERSION_WITH_TAG variable.

. $KEYMAN_ROOT/resources/shellHelperFunctions.sh

set_npm_version

3.1 KiB Raw Blame History