doc: provide instructions for building locally

[AlexCzar]

I'd like to be able to test changes on my device or in an emulator, could you please outline the steps necessary to build this locally? A short bullet-point list in the Readme will do, or even a reply to this issue.

The next task for myself is fixing Georgian layout, which in its current state is almost unusable. The layout is a bit tricky though, I'll need to experiment before I'm able to create a PR with fixes.

[calin-darie]

I have a rather outdated setup, but the project is simple enough and doesn't depend on any third party library, so it should be easy to upgrade in theory.

gradle-5.1.1 jdk 1.8 version 11.0.10 Android Studio Arctic Fox 2020 3.1 Patch 4

You should be able to debug in the emulator, used it once, but I usually try it out on my phone connected via USB.

No env variables need to be set, no extra tooling to install, if it's not straightforward to run please let me know here.

• The thing is so simple, I initially thought I"d be able to build it without full-blown android-specific sdk, just a tool like aapt, but I failed to do it in an evening so I gave up

[francoisnicolas]

When you compile the project and try to install the app Android Studio tells, Could not identify launch activity: Default Activity not found Error while Launching activity

go to folder : extra-keyboard-layouts-master\app\build\outputs\apk\debug in command line (MS-DOS in windows), type : adb install -d -t -r app-debug.apk

Then go in keyboard settings (android settings, search keyboard, mouse,track pad), press on the physical keyboard name, Configuration long press on language to disable long press on language to (re-)enable

generate kcm file based on different language: https://exkeymo.herokuapp.com/simple (modify one letter on the site, generate, and rectify later) unzip file search kcm file add it to your project

[calin-darie]

With v1.28, I've updated the tooling: gradle 7.3.1 compileSdkVersion 33 buildToolsVersion 33.0.1

Android Studio 2021.2.1 or newer required. Edit: I'm using Android Studio 2021.3.1 Patch 1

[calin-darie]

When you compile the project and try to install the app Android Studio tells, Could not identify launch activity: Default Activity not found Error while Launching activity

For me, it's simply Run App I think the key is to select Launch: Nothing under Run / Debug Configurations

[calin-darie]

Can I somehow source control this launch config? (Question for another day, I'm tired)

[calin-darie]

generate kcm file based on different language: https://exkeymo.herokuapp.com/simple (modify one letter on the site, generate, and rectify later)

Thanks, didn't know about this tool

[francoisnicolas]

I have tried French physical keyboard and the translation of key is incorrect In French keyboard , we have

1 2 3 4 5 6 7 8 9 0 ° + (we have to press SHIFT to get digits) & é " ' ( - è _ ç à ) =

and I get US keyboard

! " £ $ % ^ & * ( ) _ + 1 2 3 4 5 6 7 8 9 0 - =

letters are OK

It's perhaps an android bug.

[calin-darie]

@AlexCzar may I close this?

[francoisnicolas]

In fact, it's XIaomi smartphone that doesn't work for these keys. On Samsung, it works. You can close.