1
0
Fork 0
tt9/docs/installation.md
Dimo Karaivanov 9cae5e8129 Documentation update (#527)
* play store and uptodown links

* uptodown install instructions

* removed the IzzyOnDroid link
2024-05-25 15:02:03 +03:00

4.2 KiB

Traditional T9 Installation Guide

Devices that allow installing APKs

From F-Droid

The recommended way of installing is using F-droid. It will automatically manage downloads and keep TT9 up-to-date. The downside is new versions may become available as late as two weeks after the official release on Github.

If you don't have F-droid, get the official F-droid APK from https://f-droid.org/ and install it. For more info, refer to the installation instructions.

After you get F-droid working, just open it, search for "Traditional T9" and install it.

From Uptodown

Uptodown is similar to F-droid. You can get Traditional T9 easily, but new versions become available at least a week after the Github release.

If you don't have the Uptodown Store, download and install it from uptodown.com.

From GitHub

If you would like to run the latest version as soon as it is released, go to the GitHub Releases section. Then either download the APK on your phone or download it on a computer and transfer it to the phone. After that, just click or tap to install. If custom APK installation is enabled, it will just work. If not, your phone may show a popup, asking you to grant the installation permission, before proceeding.

In some cases, installation permissions are disabled by default, but you can usually enable them by going to Android Settings → Apps → Settings → Security, then enabling "Installation from unknown sources".

The setting name or location may be different on different Android versions. Nevertheless, a quick Google search for your phone make and model, should point you in the right direction.

Devices that do not allow installing APKs or do not display TT9 after installation

Some manufacturers prefer to lock their devices and disallow installing or enabling (or both) third-party keyboards or apps in general. It is likely to reduce the complaints "my phone isn't working", caused by the manually installed apps. The problem has been discussed here and here.

Examples of such phones include some Kyocera models, for example, the DuraXV Extreme+, ZMI Z1, all models by Sonim, and so on. On Sonim XP3800 and XP5800, there is an "Install from Unknown Sources" option, but since the November 2022 update, the phone will still refuse to install APKs unless they have been sent to and approved by Sonim.

Prepare Your Computer

To install TT9 on such locked devices, you will have to connect your phone to a computer and use a program called "adb" (Android Debug Bridge). If you feel confident using the command line, follow the instructions below.

First, go through the adb quick setup. If you need more detailed info, see the developer documentation.

Prepare the Phone

If you have successfully enabled the Developer Mode while setting up ADB, proceed to the next step.

On older phones, the Developer Mode cannot be enabled by clicking the build number. Instead, it is done by dialing a special code which usually looks like this: *#*#XXXX#*#*, where XXXX is some number. Find the code for your phone and dial it. Usually, phones from the same company, running the same Android version, share the same code. For example, the code for Sonim XP3800 also works on XP5800.

The procedure on your phone may be entirely different from the methods described above, but Google is your friend. It should be fairly easy to find how to do it unless your phone is completely locked.

Install

If your phone permits installing APKs, skip this step and install normally. Otherwise, install using:

adb install /path/to/apk/on/your/computer/tt9-vXXX.apk

If you are installing over a previously installed version, you may have to uninstall the old one first. See below.

Enable

adb shell ime enable io.github.sspanak.tt9/.ime.TraditionalT9

That's it! TT9 should appear the next you start typing.

Uninstall

adb shell pm uninstall io.github.sspanak.tt9