spiegel-keyman/developer/docs/help/guides/distribute/install-kmp-android.md
Marc Durdin b751336c13 refactor(developer): copy dev 17.0 help into repo
1. Copy help.keyman.com/developer/17.0/* into /developer/docs/help
2. Update references to 18.0 where appropriate
3. Copy all referenced images from /cdn/dev into
   /developer/docs/help/images and update links in documentation

Next commit: add deployment to help-keyman-com.sh. Note: simplest way to
test links at this point is to use the help.keyman.com auto deploy and
wait for the PR on help.keyman.com to be validated; we could look at an
internal link validation tool that verifies markdown links?

Relates-to: #12347
2024-09-16 08:46:24 +07:00

2.7 KiB

title
Installing Custom Keyboards to your Android Device

Overview

In Keyman for Android 10.0, we added the ability to easily download/share custom keyboards to your Android device.

Installing a custom keyboard

To install a custom keyboard, you will need a link to download the keyboard package. If you have already copied the kmp file onto the Android device, skip to Step 2.

If you want to build and dev your own keyboard, you will need some technical skills for this, and can read our full step-by-step instructional on how to do this here.

Once you have a website or email with a link to the keyboard package, follow these steps on your Android device to download and install the keyboard package into the Keyman for Android application:

The link in this example is for Khmer Angkor keyboard.

Step 2) Add Keyboard from Device

Once the KMP file is on your device, you will need to browse to the KMP file and select it. From the Keyman menu, select "Settings". From the Keyman Settings menu, select "Add Keyboard from Device".

The device will launch a file browser where you'll browse to the directory of your KMP file. A common places to look is the "Downloads" folder.

Selecting the KMP file should bring you to Step 3)

Step 3) Grant Keyman for Android access to storage (Android 6.0+ only)

On Android 6.0 (Marshmallow) and higher, mobile apps need to request permission to access storage. Keyman for Android needs access to read storage for installing the KMP file. At the dialog, select "ALLOW". Once authorized, Keyman for Android won't need to ask for storage permission again, unless the user revokes or uninstalls the app.

Older versions of Android grant Storage permissions at app installation time, so those users can skip this step.

Step 4) Keyboard Package welcome screen

Keyman for Android will parse the metadata in the package. If the keyboard package includes a "welcome.htm" file, this will be displayed at the confirmation to install the keyboard package

If "welcome.htm" is not included, a generic page with the package ID and package version will be shown.

Click the left "Install" button to install the entire keyboard package

Step 5) The keyboard is successfully installed!

All the keyboards in the package are installed as a group. In this example, the package only has the "Khmer Angkor" keyboard, so it becomes the active keyboard