spiegel-keyman/developer/docs/help/guides/test/keyboard-touch-mobile-emulator.md
Marc Durdin 6014885666 docs: remove old content that is deprecated by walkthrough
Remove old content and place redirects where the content is adequately
replaced by the new walkthrough. Leaves some content which does not
overlap the walkthrough. Moved reference information about package
contents.

Test-bot: skip
2026-03-09 15:04:26 +01:00

51 lines
2.5 KiB
Markdown

---
title: How to test your touch layout in the Google Chrome mobile emulator
---
This post builds on knowledge in another article about [testing Keyman
touch layouts](keyboard-touch-and-desktop). Now, we provide an
alternative test platform for your keyboards, running on your desktop
computer rather than your touch device.
Google Chrome includes a mobile emulator for web pages, for various
devices including iPhones, iPads and Androids. Recent builds of
KeymanWeb work well with this emulator and this provides a quicker and
easier way, in many cases, to get a feel for the layout of your keyboard
and do rapid testing.
It is still essential to test your layout on a real device as well as
the emulator: the feel of clicking on keys with a mouse is very
different, and gestures such as longpress menus will feel awkward on the
emulator. We use both native mobile and emulator testing when building
our layouts, switching between the two frequently. Some of the emulated
devices emulated may or not work as well a real device.
## Test Process
1. Start testing your keyboard with the [original steps on testing
touch keyboards](keyboard-touch-and-desktop).
![](../../images/testing/startdebugging-kd10.png "StartDebugging")
2. Open Chrome, navigate to the debug host page for your keyboard, and
press F12.
![Chrome1](../../images/testing/chrome1.png "Chrome1")
3. In the Developer Tools window, click the mobile icon:
![Chrome2](../../images/testing/chrome2.png "Chrome2")
4. Back in the debug host page, select the appropriate device from the
mobile emulation toolbar, then press F5 to reload and enable the
touch mode. Some recommended devices are iPad or iPad Pro for tablet
testing, and iPhone X or Nexus 6P for mobile testing. Do not select
"Responsive".
![Chrome3](../../images/testing/chrome3.png "Chrome3")
5. At this point, you should see a simulation of selected device's
screen, and KeymanWeb should be presenting its touch keyboard rather
than the desktop equivalent. You'll also see the mouse cursor has
turned into a fuzzy circle, to simulate a fingertip instead of a
precise arrow.
![Chrome4"](../../images/testing/chrome4.png "Chrome4")
You can now test the keyboard layout and get an idea of how it will feel
on a real touch device. Rotation, or changing device types will require
a page load (F5) in order to render correctly.
- [How to test your keyboard layout — touch and
desktop](keyboard-touch-and-desktop)