Skip to content

Desktop app compatibility tests

Jump to bottom
Makara edited this page Mar 17, 2023 · 10 revisions

The basic idea is to load the app or test page, and then test input with latest release version of Keyman apps and a variety of keyboards.

Gather Assets for Testing

Install the following keyboards and have the test page link ready to load on the respective browser.

  • Keyman app - Latest version (please record the version in the test results)
  • Khmer Angkor keyboard package
  • EuroLatin (SIL) keyboard pagekage
  • Galaxie Hebrew (Positional) keyboard package
  • IPA (SIL) keyboard package
  • The editor being tested should have a test page with text area to type and test, i.e. Slatejs text editor test page

User Testing

The app may need to be tested in multiple environments. Each environment can be defined as a group here. For example, if you wanted to test a web app, you may have the following groups:

  • GROUP_WIN10_CHROME: Windows 10 / Chrome browser
  • GROUP_WIN10_FIREFOX: Windows 10 / Firefox browser
  • GROUP_MACOS_CHROME: macOS / Chrome browser
  • GROUP_MACOS_FIREFOX: macOS / Firefox browser
  • GROUP_MACOS_SAFARI: macOS / Safari browser
  • GROUP_UBUNTU_CHROME: Ubuntu / Chrome browser
  • GROUP_UBUNTU_FIREFOX: Ubuntu / Firefox browser

Load "the app or 'test page' being tested" on the respective OS (and browser) to test the followings:

  • TEST_KHMER_ANGKOR: Khmer Angkor
    • Ensure the key combination AltGr B produces ឞ. Note that on macOS, the function key to use is right option.
    • Type the following (US) keys in sequence: s u j r k. You should see ស្រុក.
  • TEST_SIL_EURO_LATIN: SIL Euro Latin
    • Type % a. Ensure the output is ǎ
  • TEST_GALAXIE_HEBREW: Galaxie Hebrew or another good SIL RTL keyboard
    • Type b \ = r @ a v ! y t to output בְּרֵאשִׁית. FAILED if the output is different.
  • TEST_SIL_IPA: sil_ipa
    • Ensure the key sequence n > produces ŋ.
  • TEST_INTERACTION_WITH_TEXT_FORMATTING:
    • when a Keyman keyboard is active and you are able to enable bold by using the keyboard shortcut (i.e. Ctrl + b).
    • PASSED if the bold is enabled on the first character and the rest of the text being typed, otherwise FAILED.
    • Note that on macOS, the keyboard shortcut for Bold is command+b.
  • TEST_CJK_IMX: Korean KORDA Jamo (SIL)
    • Type h a n <space> g e u l <space>. Verify that the result is 한글.
Clone this wiki locally