Android keyboard with AnySoftKeyboard

README.md

@@ -15,6 +15,9 @@ http://normanlayout.info/files/Norman.dmg
 
 https://help.ubuntu.com/stable/ubuntu-help/keyboard-layouts.html
 
+## Android Keyboard (through AnySoftKeyboard)
+See [Android's README](android/README.md).
+
 ## Key assignments
 
 ![Norman](images/norman_mac.png)

android/README.md

@@ -0,0 +1,50 @@
+# How to install the keyboard for usage with AnySoftKeyboard
+
+This keyboard comes with the English dictionary pre-activated. You are able to override this configuration after installing; for that, see the details in the bottom.
+
+## Steps for using Norman with AnySoftKeyboard
+
+1. Install AnySoftKeyboard
+
+You'll be able to get the APK in one of those ways:
+
+- Through the F-Droid store.
+- Through Google PlayStore.
+- Through the project's [Github's release page](https://github.com/AnySoftKeyboard/AnySoftKeyboard/releases) - just download the latest app-release.apk and install it.
+
+
+2. Install the English language pack pre-built with Norman
+
+*Do not worry about this being an "English" language pack as you'll be able to use with whatever language you want by overriding the dictionary.*
+
+The pre-built addon for enabling Norman is distributed through [NormanAddonAnySoftKeyboard.apk](NormanAddonAnySoftKeyboard.apk).
+
+*PS:* It is pre-built only for the sake of getting it without having to setup the Android SDK and manually compiling, for people who don't have it. Regardless, you're also able to see the source and compile by yourself.
+
+https://github.com/resolritter/NormanLayoutAnysoftKeyboard
+
+
+3. Go into **AnySoftKeyboard** -> **Languages** (the "globe" icon in the bottom row) -> **Enable keyboards and languages**, and choose Norman.
+
+
+---
+
+## (Optional) Custom dictionary configuration
+
+If you plan to use the keyboard to write in another language other than English, you'll want to override the dictionary configuration.
+
+1. Swipe up the space key to get to the keyboard's menu, then click the gear icon
+
+![swipe-up](swipe-up.jpg)
+
+2. Select **Override default dictionary**
+
+![override-dict](override-dict.jpg)
+
+As for getting the extra dictionaries, you'll need to install the language addons from the stores or build them yourself from [LanguagePack](https://github.com/AnySoftKeyboard/LanguagePack).
+
+## (Optional) Change the special press-and-hold symbols for each key
+
+**This will require you to modify the source code and recompile the APK.**  See the source repository for instructions on how to do this.
+
+https://github.com/resolritter/NormanLayoutAnysoftKeyboard