Mobile Keyboard Testing Guide
- Clarissa Forbes (Unlicensed)
This guide is meant for beta testers of unreleased FirstVoices keyboards.
Introduction
Thank you for testing out one of our new or improved keyboards! Before you get started, there are a few steps you need to take. Normally, our keyboards are available through our FirstVoices Keyboards App, but since the version you will be sent is not officially released there are a few steps you need to take before testing.
Installation / Setup guide
The first step you will need to take is install the Keyman App. Keyman is the software we use to develop and update our keyboards before we officially release them. Keyman has its own app that you will be using to test these unreleased keyboards.
The screenshots taken for this tutorial come from a Samsung Z Flip3. Some icons and layouts may look different depending on your device. If you need help finding anything, please reach out to us and we will help you out!
Installing the Keyman App
Open up Google Play or the App Store on your device. Search for “Keyman”. The first result should be the Keyman App. Tap install, then open the app.
 1. Searching for Keyman in Google Play
|  2. Official Keyman app
|
|---|---|
 3. Keyman app page once the download is complete
|
|
Allow Keyman to send notifications and close out of the Get Started page. Unchecking the “Show “Get Started” on startup” will prevent it from popping up in the future.
 4. Notification permission pop-up when opening Keyman for the first time |  5. “Get Started” pop-up
|
|---|
Bring up the menu drop down by tapping the three dots in the top right corner, and select “Settings”. Check off “Enable Keyman as a system-wide keyboard”. This will take you to the keyboard settings window
 6. Keyman homepage with menu drop down highlighted
|  7. Menu drop down with “Settings” highlighted
|
|---|---|
 8. Settings menu with “Enable Keyman[…] keyboard” highlighted
|
|
Toggle Keyman on and press ok
 9. Keyboard setting with “Keyman” highlighted |  10. Pop-up saying you need to unlock your phone after updating to use the keyboard
|
|---|
Keyman is now installed and the keyboard can be used across your device!
Installing Keyboard to Test
Once you have installed Keyman, you are ready to move on to installing the keyboard for testing!
You will receive an email with the keyboard to test when it is ready that includes a .zip file. Click on the attachment, and download it to the device you want to test the keyboard on.
 1. Example email with attachment highlighted |  2. Pop-up asking where you would like to save the file to
|
In your notifications menu, there will be a notification that the folder has downloaded. Tap here and it will take you to the folder in your phone or tablets Files.
3. Notification menu showing file download is completeAlternatively, you can open your Files app if you know where it is located. Select the folder for the keyboard you just downloaded
 4. The My Files app on Samsung This may be located somewhere else or look different depending on the model of your device and how you’ve customised or organised your device. |  5. The My Files app homescreen with the .zip file highlighted
|
|---|
Once you are in the folder, choose to extract the file and save it under the name it downloaded as
 6. Opened .zip file with Extract option highlighted
|  7. Naming pop-up
|
|---|
Once you have extracted and saved the file, open Keyman
Once Keyman is open, click the three dots in the top right corner to open the menu dropdown, then select “Settings”
9. Keyman App with three dots (menu button) highlighted | 10. Menu drop down with “Settings” highlighted
|
|---|
In Settings, select “Install Keyboard or Dictionary”, then “Install from local file”. This will open up your File browser
 11. Settings with “Install Keyboard or Dictionary” highlighted
|  12. Installation page with “Install from local file” highlighted
|
|---|
In your File Browser, open up the extracted folder, then the .kmp file inside of it.
 13. Extracted folder in Downloads folder highlighted |  14. .kmp file within folder
|
|---|
The screen will display the keyboard’s install page with some brief information on the keyboard, followed by the welcome screen with further information and resources for using the keyboard. If there are any links that don’t work, files that won’t open, or instructions that don’t match how the keyboard works, please let us know.
 15. Installation pop-up
|  16. Completed installation page
|
|---|
Open the app of your choosing and tap on a text box. Your default keyboard should pop up, and in the bottom right corner there should be a small keyboard icon. Selecting that will open up your keyboards menu. From there, you should be able to select the Keyman app. If Keyman is not showing, please go back to the Keyman installation instructions and ensure you have toggled it on in your system settings.
Once this is complete, you are ready to test the keyboard!
 17. Opened keyboard with Input Method icon highlighted |  18. Input Method pop-up
|
|---|---|
 19. Keyman keyboard ready to use! |
|