mirror of
https://github.com/keymanapp/keyman.git
synced 2026-08-07 01:15:33 +00:00
67 lines
2.7 KiB
Markdown
67 lines
2.7 KiB
Markdown
# Keyman Engine for Web
|
|
The Original Code is (C) SIL International
|
|
|
|
## Prerequisites
|
|
See [build configuration](../docs/build/index.md) for details on how to
|
|
configure your build environment.
|
|
|
|
**********************************************************************
|
|
|
|
The following folders contain the distribution for Keyman Engine for Web:
|
|
|
|
source Source code
|
|
source/resources/osk OSK resources for inclusion in mobile app builds;
|
|
keymanweb-osk.ttf is maintained at https://github.com/silnrsi/font-keymanweb-osk
|
|
unit_tests Automated testing resources
|
|
|
|
build/web/release Fully-compiled KeymanWeb modules for release
|
|
build/embed/release Fully-compiled KMEA/KMEI modules for inclusion in mobile app builds
|
|
build/web/debug Fully-compiled but non-minified KeymanWeb modules
|
|
build/embed/debug Fully-compiled but non-minified KMEA/KMEI modules
|
|
|
|
samples Sample pages demonstrating ways to link with KeymanWeb
|
|
testing Test-case web-pages for various aspects of KeymanWeb functionality
|
|
unit_tests A Node-driven test suite for automated testing of KeymanWeb
|
|
|
|
**********************************************************************
|
|
|
|
## Usage
|
|
Open **index.html** or **samples/index.html** in your browser. Be sure to
|
|
compile Keyman Engine for Web before viewing the pages.
|
|
|
|
Refer to the samples for usage details.
|
|
|
|
To view pages using compiled Keyman Engine for Web,
|
|
1. cd to **keyman/web/source**
|
|
2. Run `./build.sh`
|
|
- Use `./build.sh --help` for the script's documentation.
|
|
|
|
### Unit Testing ###
|
|
|
|
Before running unit tests on Keyman Engine for Web, first run `./build.sh`
|
|
according to the instructions above.
|
|
|
|
Once the build is complete, running `npm test` will run the unit testing suite
|
|
on your local machine in-browser. Alternatively, see `unit_tests/test.sh`, which
|
|
the former command executes.
|
|
|
|
### Debugging Unit Tests
|
|
1. During development, to run a specific unit test, change the `it` to
|
|
`it.only`. You can also run all tests under a specific group with
|
|
`describe.only`.
|
|
2. From this directory, run `./unit_tests/test.sh -debug`. Alternatively, from
|
|
`web/` or any `web/` subdirectory,
|
|
|
|
```
|
|
npm run test -- -debug
|
|
```
|
|
|
|
The `--` part tells `npm` to funnel anything to the script as the script's
|
|
command-line parameters. As long as it's run from somewhere within the `web/`
|
|
folder's hierarchy, that line will always run from `web/`, as that's where
|
|
`package.json` is.
|
|
|
|
3. When the browser halts, click the "Debug" button which opens a new debugging
|
|
tab.
|
|
4. In the Dev console, you can set a breakpoint in your test and refresh the
|
|
page to debug
|