iOS keyboard package cannot be installed in the Keyman app (keyboard testable properly in phone browser)

Greetings! I’m new to Keyman Developer though I’ve been using some Keyman keyboards and have been creating my own keyboards with Ukelele for many years.

Recently I started a test project trying to make an iOS keyboard and the process was fairly smooth. I simply repeated my layout for the macOS previously made in Ukelele and rearranged a bit in the touch design for iPhone and everything looked great: I could test the layout on my phone browser; I could type properly and the Arabic based script connects properly; (additional) diacritics were fine; long-press keys worked fine. But, I cannot get it properly installed in the Keyman app.

Before I was able to test it in my phone browser, I actually tried the “install from file” option by transferring the .kmp file to my phone and the issue was already there. I initially suspected there might be something wrong with my package so I purchased a USB wifi adapter in order to put my virtual Windows on the same network with my phone to test the keyboard. But the issue remained the same.

According to the instructions, no matter how the package is loaded onto the phone (browser download or “install from file”), once I click in the file, the normal installation process should start. But I never saw it. I am sure I set the language code properly, but I cannot find if from the language list. I tried uninstalling and reinstalling Keyman from my phone and the issue persists.

When I go to “installed languages” on my phone, a green banner pops up from below saying “update available.” I can click on it and in a second or two, it turns into “updates successfully downloaded” and disappears. I assumed it could be something about my test layout being loaded, but I could not find it in the language list, and this green banner shows up every time I go to “installed language” after I clicked on the .kmp file (previously via file transfer, currently via the installation link from the phone browser test page). This was the same issue before I managed to test the keyboard in my phone browser.

Does anybody know what is going on?

Many thanks!

Welcome to our community.

Could you give us some more details?

  1. What is your iOS version?
  2. What is the Keyman version you are using to test this keyboard?
  3. Can you DM us the keyboard so we can test it on our side?

Thank you for your response.

My iOS version is 14.2. The Keyman app I installed is 13.0.113.

By DM do you mean I could message you and attach the .kmp file?

Btw, here is the image after I clicked on the “update available” banner. I was not allowed to attach more than one image when I posted the question.

Thank you for the info. :slight_smile:

You can click on my profile picture, then Message and then you should be able to start a direct message.

You can copy and paste as many images as you need right in the text box.

Thanks! I have just messaged you with the .kmp file I made.

And, thank you, I did know how to attach images and I tried to attach more images when I created the post, but I was somehow not allowed as a new member lol I attached the second image to show what I described originally in my post. Even now, when I go to settings — installed languages, the green banner pops up as in my first image, and I can click on it, then it disappears to show the second image, and then the green banner disappears entirely. However, nothing appears to be added in the language list. If I exit and go to ‘installed languages’ again, the whole thing repeats.

Ah, newbie issue. :smiley:

Probably you can upload the images to Google Drive and share the link with me.

I will get the iOS developer in the loop and we’ll see what is going on. Thank you for the report. :+1:

Thank you. I’ll try other ways of image sharing next time.
And thanks for bringing in the tech team. Looking forward to a conclusion for this mystery.

It looks like I’ll need additional information regarding your issue - everything is working fine on my end.

When testing in the iOS Simulator:

Testing on my personal device:

That said, it’s probably worth noting that I’m doing these tests on the current Keyman 14.0 alpha. There’s a small chance that there’s something specific to the currently-released Keyman 13.0 that’s going wrong… assuming that you’re on that version. Even then, I still get a valid install within Keyman 13.0, at least on the Simulator.

One more question - when Keyman launches after trying to ‘open’ the KMP (from Files, from an email attachment, etc), does anything show up that references your package? I’d expect something like this to show up:

Thank you so much for your response!

It is indeed weird… I could test it pretty well in the browser, no luck at all for the installation.

When I navigate to the KMP file from ‘install from file’ in the Keyman app and tap on the KMP file, nothing happens at all. It just remains on the file viewer page. Nothing pops up, as if I did not tap on anything. The very last image you showed never appeared on my phone. I read from instructions that I should expect the normal installation process but it did not initiate.

Hi, Does anyone have a video on how to use Keyman Developer because I need a example.

Hi @YawReh, welcome to the community :slight_smile:

Have a look at our Keyman Developer Training Videos at – there are a whole set of training videos that take you from the very beginning through to a complete keyboard ready to share with your language community.